@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/automation/service.js

@@ -0,0 +1,205 @@
+import { randomUUID } from 'node:crypto';
+import { PersistentStore } from '@pellux/goodvibes-sdk/platform/state/persistent-store';
+import { ConfigManager } from '../config/manager.js';
+import { AutomationManager } from './manager.js';
+import { migrateLegacySchedules } from '@pellux/goodvibes-sdk/platform/automation/migration';
+import { AutomationJobStore } from '@pellux/goodvibes-sdk/platform/automation/store/jobs';
+import { resolveAutomationStorePath } from '@pellux/goodvibes-sdk/platform/automation/store/paths';
+import { AutomationRouteStore } from '@pellux/goodvibes-sdk/platform/automation/store/routes';
+import { AutomationRunStore } from '@pellux/goodvibes-sdk/platform/automation/store/runs';
+import { AutomationSourceStore } from '@pellux/goodvibes-sdk/platform/automation/store/sources';
+function sortJobs(jobs) {
+    return [...jobs].sort((a, b) => a.name.localeCompare(b.name) || a.createdAt - b.createdAt);
+}
+function sortRuns(runs) {
+    return [...runs].sort((a, b) => b.queuedAt - a.queuedAt);
+}
+function sortRoutes(routes) {
+    return [...routes].sort((a, b) => b.lastSeenAt - a.lastSeenAt || a.id.localeCompare(b.id));
+}
+function sortSources(sources) {
+    return [...sources].sort((a, b) => a.label.localeCompare(b.label) || a.createdAt - b.createdAt);
+}
+export class AutomationService {
+    jobStore;
+    runStore;
+    routeStore;
+    sourceStore;
+    legacyStore;
+    manager;
+    jobs = new Map();
+    runs = new Map();
+    routes = new Map();
+    sources = new Map();
+    loaded = false;
+    constructor(config) {
+        const configManager = config.configManager;
+        this.jobStore = config.jobs ?? new AutomationJobStore({ configManager });
+        this.runStore = config.runs ?? new AutomationRunStore({ configManager });
+        this.routeStore = config.routes ?? new AutomationRouteStore({ configManager });
+        this.sourceStore = config.sources ?? new AutomationSourceStore({ configManager });
+        this.legacyStore = config.legacyStore ?? new PersistentStore(resolveAutomationStorePath('schedules.json', configManager));
+        if (!config.manager) {
+            throw new Error('AutomationService requires an explicit AutomationManager instance');
+        }
+        this.manager = config.manager;
+    }
+    async start() {
+        await this.manager.start();
+    }
+    stop() {
+        this.manager.stop();
+    }
+    async load() {
+        if (this.loaded)
+            return;
+        const [jobSnapshot, runSnapshot, routeSnapshot, sourceSnapshot] = await Promise.all([
+            this.jobStore.load(),
+            this.runStore.load(),
+            this.routeStore.load(),
+            this.sourceStore.load(),
+        ]);
+        this.jobs.clear();
+        this.runs.clear();
+        this.routes.clear();
+        this.sources.clear();
+        for (const job of jobSnapshot.jobs)
+            this.jobs.set(job.id, job);
+        for (const run of runSnapshot.runs)
+            this.runs.set(run.id, run);
+        for (const route of routeSnapshot.routes)
+            this.routes.set(route.id, route);
+        for (const source of sourceSnapshot.sources)
+            this.sources.set(source.id, source);
+        this.loaded = true;
+    }
+    listJobs() {
+        return sortJobs(this.jobs.values());
+    }
+    listRuns(jobId) {
+        const runs = jobId
+            ? [...this.runs.values()].filter((run) => run.jobId === jobId)
+            : this.runs.values();
+        return sortRuns(runs);
+    }
+    listRoutes() {
+        return sortRoutes(this.routes.values());
+    }
+    listSources() {
+        return sortSources(this.sources.values());
+    }
+    getJob(jobId) {
+        return this.jobs.get(jobId);
+    }
+    getRoute(routeId) {
+        return this.routes.get(routeId);
+    }
+    getSource(sourceId) {
+        return this.sources.get(sourceId);
+    }
+    async upsertJob(job) {
+        await this.load();
+        this.jobs.set(job.id, job);
+        if (job.source) {
+            this.sources.set(job.source.id, job.source);
+        }
+        await Promise.all([this.saveJobs(), this.saveSources()]);
+        return job;
+    }
+    async upsertRun(run) {
+        await this.load();
+        this.runs.set(run.id, run);
+        this.sources.set(run.triggeredBy.id, run.triggeredBy);
+        if (run.route) {
+            this.routes.set(run.route.id, run.route);
+        }
+        await Promise.all([this.saveRuns(), this.saveRoutes(), this.saveSources()]);
+        return run;
+    }
+    async appendRun(run) {
+        const timestamp = run.createdAt ?? Date.now();
+        const persisted = {
+            ...run,
+            id: run.id ?? `run-${randomUUID().slice(0, 8)}`,
+            updatedAt: run.updatedAt ?? timestamp,
+        };
+        return await this.upsertRun(persisted);
+    }
+    async upsertRoute(route) {
+        await this.load();
+        this.routes.set(route.id, route);
+        await this.saveRoutes();
+        return route;
+    }
+    async upsertSource(source) {
+        await this.load();
+        this.sources.set(source.id, source);
+        await this.saveSources();
+        return source;
+    }
+    async removeJob(jobId) {
+        await this.load();
+        const removed = this.jobs.delete(jobId);
+        if (!removed)
+            return false;
+        for (const [runId, run] of this.runs) {
+            if (run.jobId === jobId)
+                this.runs.delete(runId);
+        }
+        for (const [routeId, route] of this.routes) {
+            if (route.jobId === jobId)
+                this.routes.delete(routeId);
+        }
+        await Promise.all([this.saveJobs(), this.saveRuns(), this.saveRoutes()]);
+        return true;
+    }
+    async removeRoute(routeId) {
+        await this.load();
+        const removed = this.routes.delete(routeId);
+        if (!removed)
+            return false;
+        await this.saveRoutes();
+        return true;
+    }
+    async removeSource(sourceId) {
+        await this.load();
+        const removed = this.sources.delete(sourceId);
+        if (!removed)
+            return false;
+        await this.saveSources();
+        return true;
+    }
+    async seedFromLegacyScheduler(snapshot) {
+        await this.load();
+        if (this.jobs.size > 0 || this.runs.size > 0)
+            return;
+        const sourceSnapshot = snapshot ?? await this.legacyStore.load() ?? {};
+        const migrated = migrateLegacySchedules(sourceSnapshot);
+        if (migrated.jobs.length === 0 && migrated.runs.length === 0)
+            return;
+        for (const job of migrated.jobs) {
+            this.jobs.set(job.id, job);
+            this.sources.set(job.source.id, job.source);
+        }
+        for (const run of migrated.runs) {
+            this.runs.set(run.id, run);
+            this.sources.set(run.triggeredBy.id, run.triggeredBy);
+            if (run.route) {
+                this.routes.set(run.route.id, run.route);
+            }
+        }
+        await Promise.all([this.saveJobs(), this.saveRuns(), this.saveRoutes(), this.saveSources()]);
+    }
+    async saveJobs() {
+        await this.jobStore.save(sortJobs(this.jobs.values()));
+    }
+    async saveRuns() {
+        await this.runStore.save(sortRuns(this.runs.values()));
+    }
+    async saveRoutes() {
+        await this.routeStore.save(sortRoutes(this.routes.values()));
+    }
+    async saveSources() {
+        await this.sourceStore.save(sortSources(this.sources.values()));
+    }
+}

package/dist/_internal/platform/bookmarks/manager.d.ts

@@ -13,7 +13,7 @@ export interface BookmarkEntry {
  * BookmarkManager - Tracks bookmarked blocks and saves block content to disk.
  *
  * Bookmarks are stored in memory for the session. Saved block content is
- * written to ~/.goodvibes/tui/bookmarks/<timestamp>-<label>.txt.
+ * written to ~/.goodvibes/goodvibes/bookmarks/<timestamp>-<label>.txt.
  */
 export declare class BookmarkManager {
     private bookmarks;

package/dist/_internal/platform/bookmarks/manager.js

@@ -5,7 +5,7 @@ import { logger } from '../utils/logger.js';
  * BookmarkManager - Tracks bookmarked blocks and saves block content to disk.
  *
  * Bookmarks are stored in memory for the session. Saved block content is
- * written to ~/.goodvibes/tui/bookmarks/<timestamp>-<label>.txt.
+ * written to ~/.goodvibes/goodvibes/bookmarks/<timestamp>-<label>.txt.
  */
 export class BookmarkManager {
     bookmarks = new Map();

package/dist/_internal/platform/channels/builtin/account-actions.d.ts

@@ -0,0 +1,12 @@
+import type { ChannelAccountLifecycleAction, ChannelAccountLifecycleResult, ChannelAccountRecord, ChannelActorAuthorizationRequest, ChannelActorAuthorizationResult, ChannelSurface } from '@pellux/goodvibes-sdk/platform/channels/types';
+import type { BuiltinChannelRuntimeDeps } from './shared.js';
+interface BuiltinAccountActionContext {
+    readonly deps: BuiltinChannelRuntimeDeps;
+    readonly buildAccount: (surface: ChannelSurface) => Promise<ChannelAccountRecord>;
+    readonly resolveAccount: (surface: ChannelSurface, accountId: string) => Promise<ChannelAccountRecord | null>;
+}
+export declare function runBuiltinAccountAction(context: BuiltinAccountActionContext, surface: ChannelSurface, action: ChannelAccountLifecycleAction, accountId?: string, input?: Record<string, unknown>): Promise<ChannelAccountLifecycleResult>;
+export declare function authorizeBuiltinActorAction(context: BuiltinAccountActionContext, surface: ChannelSurface, request: ChannelActorAuthorizationRequest): Promise<ChannelActorAuthorizationResult>;
+export declare function runBuiltinProviderApi(context: BuiltinAccountActionContext, surface: ChannelSurface, input?: Record<string, unknown>): Promise<unknown>;
+export {};
+//# sourceMappingURL=account-actions.d.ts.map

package/dist/_internal/platform/channels/builtin/account-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-actions.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/account-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,oBAAoB,EACpB,gCAAgC,EAChC,+BAA+B,EAC/B,cAAc,EACf,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAiB7D,UAAU,2BAA2B;IACnC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClF,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CAC/G;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,6BAA6B,EACrC,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,6BAA6B,CAAC,CA4IxC;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,+BAA+B,CAAC,CAmB1C;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CA4GlB"}

package/dist/_internal/platform/channels/builtin/account-actions.js

@@ -0,0 +1,437 @@
+import { DiscordIntegration, NtfyIntegration, SlackIntegration } from '../../integrations/index.js';
+import { readDirectoryScope, readSecretScope, readString, readStringList, } from '@pellux/goodvibes-sdk/platform/channels/builtin/parsing';
+import { asProviderRuntimeSurface, isManagedSurface, providerEnvBacked, providerRuntimeStatus, resolveDiscordBotToken, resolveNtfyToken, } from './surfaces.js';
+import { lookupBuiltinProviderDirectory } from './targets.js';
+export async function runBuiltinAccountAction(context, surface, action, accountId, input) {
+    const account = accountId ? await context.resolveAccount(surface, accountId) : await context.buildAccount(surface);
+    const resultAccountId = accountId ?? account?.accountId ?? account?.id;
+    const base = {
+        surface,
+        ...(resultAccountId ? { accountId: resultAccountId } : {}),
+        action,
+        ...(account ? { state: account.state, authState: account.authState } : {}),
+        account,
+    };
+    if (!account) {
+        return {
+            ...base,
+            ok: false,
+            message: 'No matching channel account was found.',
+            metadata: { requestedAccountId: accountId ?? null },
+        };
+    }
+    const providerSurface = asProviderRuntimeSurface(surface);
+    switch (action) {
+        case 'inspect':
+            return {
+                ...base,
+                ok: true,
+                message: 'Account posture inspected.',
+                metadata: {},
+            };
+        case 'retest':
+            return {
+                ...base,
+                ok: account.configured,
+                message: account.configured
+                    ? 'Account configuration is present; secret values remain hidden.'
+                    : 'Account is not configured.',
+                metadata: { configured: account.configured, linked: account.linked },
+            };
+        case 'setup':
+            if (providerSurface) {
+                return runProviderSetupAction(context, providerSurface, action, base, account, input);
+            }
+            return {
+                ...base,
+                ok: account.configured,
+                login: account.configured
+                    ? { kind: 'none' }
+                    : {
+                        kind: 'manual',
+                        instructions: 'Configure this built-in surface through GoodVibes config or the service registry.',
+                    },
+                message: account.configured
+                    ? 'Account is already configured.'
+                    : 'This built-in surface is config-backed; interactive setup is not available for it.',
+                metadata: { configBacked: true },
+            };
+        case 'connect':
+        case 'login':
+            if (providerSurface) {
+                return runProviderSetupAction(context, providerSurface, action, base, account, input);
+            }
+            return {
+                ...base,
+                ok: account.linked,
+                login: account.linked
+                    ? { kind: 'none' }
+                    : {
+                        kind: 'manual',
+                        instructions: 'Add the required credential sources in GoodVibes config, environment, or service registry.',
+                    },
+                message: account.linked
+                    ? 'Account is already linked.'
+                    : 'No mutable OAuth/QR login flow is available for this config-backed built-in surface.',
+                metadata: { configBacked: true },
+            };
+        case 'wait_login':
+            return {
+                ...base,
+                ok: false,
+                login: { kind: 'none' },
+                message: 'No interactive login is pending for this built-in surface.',
+                metadata: { pending: false },
+            };
+        case 'start':
+            if (providerSurface && context.deps.providerRuntime) {
+                const runtimeResult = await context.deps.providerRuntime.start(providerSurface);
+                const refreshed = await context.buildAccount(surface);
+                return {
+                    ...base,
+                    ok: runtimeResult.ok,
+                    account: refreshed,
+                    state: refreshed.state,
+                    authState: refreshed.authState,
+                    message: runtimeResult.message,
+                    metadata: { providerRuntime: runtimeResult.status },
+                };
+            }
+            return {
+                ...base,
+                ok: account.enabled,
+                message: account.enabled
+                    ? 'Surface is enabled in the current daemon runtime.'
+                    : 'Surface is disabled; enable it in config before starting delivery.',
+                metadata: { enabled: account.enabled },
+            };
+        case 'stop':
+            if (providerSurface && context.deps.providerRuntime) {
+                const runtimeResult = context.deps.providerRuntime.stop(providerSurface);
+                const refreshed = await context.buildAccount(surface);
+                return {
+                    ...base,
+                    ok: runtimeResult.ok,
+                    account: refreshed,
+                    state: refreshed.state,
+                    authState: refreshed.authState,
+                    message: runtimeResult.message,
+                    metadata: { providerRuntime: runtimeResult.status },
+                };
+            }
+            return {
+                ...base,
+                ok: !account.enabled,
+                message: account.enabled
+                    ? 'Stopping this built-in surface is daemon/config owned; disable it in config or stop the daemon.'
+                    : 'Surface is already disabled.',
+                metadata: { enabled: account.enabled, configBacked: true },
+            };
+        case 'disconnect':
+        case 'logout':
+            if (providerSurface) {
+                return runProviderLogoutAction(context, providerSurface, action, base, account, input);
+            }
+            return {
+                ...base,
+                ok: !account.linked,
+                message: account.linked
+                    ? 'This built-in surface is config-backed; credentials were not removed by the runtime.'
+                    : 'Account is already unlinked.',
+                metadata: { configBacked: true, linked: account.linked },
+            };
+    }
+}
+export async function authorizeBuiltinActorAction(context, surface, request) {
+    const account = request.accountId ? await context.resolveAccount(surface, request.accountId) : await context.buildAccount(surface);
+    const requestedAction = request.actionId.trim().toLowerCase();
+    const matchingAction = account?.actions.find((entry) => entry.id === requestedAction || entry.kind === requestedAction);
+    const actionAvailable = matchingAction?.available ?? Boolean(account?.configured);
+    const allowed = Boolean(account?.enabled && actionAvailable);
+    return {
+        allowed,
+        reason: allowed
+            ? 'Account is enabled and the requested action is available.'
+            : 'The account is disabled, unconfigured, or the requested action is unavailable.',
+        account,
+        actionAvailable,
+        metadata: {
+            actorId: request.actorId ?? null,
+            actionId: request.actionId,
+            target: request.target?.sessionTarget ?? request.target?.to ?? null,
+        },
+    };
+}
+export async function runBuiltinProviderApi(context, surface, input) {
+    const operation = readString(input?.operation)?.trim().toLowerCase();
+    if (!operation) {
+        return { surface, ok: false, error: 'provider-api requires operation.' };
+    }
+    if (operation === 'runtime_status') {
+        const providerSurface = asProviderRuntimeSurface(surface);
+        return providerSurface
+            ? { surface, ok: true, status: providerRuntimeStatus(context.deps, providerSurface) }
+            : { surface, ok: false, error: 'No provider runtime for this surface.' };
+    }
+    if (operation === 'runtime_start') {
+        const providerSurface = asProviderRuntimeSurface(surface);
+        return providerSurface && context.deps.providerRuntime
+            ? context.deps.providerRuntime.start(providerSurface)
+            : { surface, ok: false, error: 'No provider runtime for this surface.' };
+    }
+    if (operation === 'runtime_stop') {
+        const providerSurface = asProviderRuntimeSurface(surface);
+        return providerSurface && context.deps.providerRuntime
+            ? context.deps.providerRuntime.stop(providerSurface)
+            : { surface, ok: false, error: 'No provider runtime for this surface.' };
+    }
+    if (operation === 'live_directory') {
+        if (!isManagedSurface(surface))
+            return { surface, ok: false, error: 'Live provider directory is only available for managed external surfaces.' };
+        const scope = readDirectoryScope(input?.scope);
+        const entries = await lookupBuiltinProviderDirectory({ deps: context.deps }, surface, readString(input?.query) ?? '', {
+            ...(scope ? { scope } : {}),
+            ...(typeof input?.limit === 'number' ? { limit: input.limit } : {}),
+            live: true,
+        });
+        return { surface, ok: true, entries };
+    }
+    if (operation === 'oauth_url') {
+        if (surface === 'slack') {
+            const clientId = readString(input?.clientId) ?? process.env.SLACK_CLIENT_ID;
+            if (!clientId)
+                return { surface, ok: false, error: 'clientId or SLACK_CLIENT_ID is required.' };
+            return {
+                surface,
+                ok: true,
+                url: SlackIntegration.buildOAuthAuthorizeUrl({
+                    clientId,
+                    redirectUri: readString(input?.redirectUri),
+                    scopes: readStringList(input?.scopes) ?? ['commands', 'chat:write', 'channels:read', 'groups:read', 'im:read', 'mpim:read', 'users:read'],
+                    state: readString(input?.state),
+                    teamId: readString(input?.teamId),
+                }),
+            };
+        }
+        if (surface === 'discord') {
+            const configuredClientId = String(context.deps.configManager.get('surfaces.discord.applicationId') || '');
+            const clientId = (readString(input?.clientId) ?? configuredClientId) || process.env.DISCORD_APPLICATION_ID;
+            if (!clientId)
+                return { surface, ok: false, error: 'clientId, applicationId, or DISCORD_APPLICATION_ID is required.' };
+            return {
+                surface,
+                ok: true,
+                url: DiscordIntegration.buildOAuthAuthorizeUrl({
+                    clientId,
+                    redirectUri: readString(input?.redirectUri),
+                    guildId: readString(input?.guildId),
+                    permissions: readString(input?.permissions) ?? '2048',
+                    scopes: readStringList(input?.scopes) ?? ['bot', 'applications.commands'],
+                    disableGuildSelect: typeof input?.disableGuildSelect === 'boolean' ? input.disableGuildSelect : undefined,
+                    state: readString(input?.state),
+                }),
+            };
+        }
+        return { surface, ok: false, error: 'OAuth URL generation is not available for this surface.' };
+    }
+    if (operation === 'register_command' && surface === 'discord') {
+        const applicationId = readString(input?.applicationId) ?? String(context.deps.configManager.get('surfaces.discord.applicationId') || '');
+        const guildId = readString(input?.guildId) ?? String(context.deps.configManager.get('surfaces.discord.guildId') || '');
+        const token = await resolveDiscordBotToken(context.deps);
+        if (!applicationId || !guildId || !token) {
+            return { surface, ok: false, error: 'applicationId, guildId, and bot token are required.' };
+        }
+        const discord = new DiscordIntegration(undefined, token);
+        const command = typeof input?.command === 'object' && input.command !== null
+            ? input.command
+            : DiscordIntegration.buildGoodVibesCommand();
+        const registered = await discord.registerGuildCommand(applicationId, guildId, command);
+        return { surface, ok: true, command: registered };
+    }
+    if (operation === 'subscribe_url' && surface === 'ntfy') {
+        const topic = readString(input?.topic) ?? String(context.deps.configManager.get('surfaces.ntfy.topic') || '');
+        if (!topic)
+            return { surface, ok: false, error: 'topic is required.' };
+        const ntfy = new NtfyIntegration(String(context.deps.configManager.get('surfaces.ntfy.baseUrl') || 'https://ntfy.sh'));
+        return {
+            surface,
+            ok: true,
+            urls: {
+                json: ntfy.buildSubscribeUrl(topic, 'json', { since: readString(input?.since) }),
+                websocket: ntfy.buildSubscribeUrl(topic, 'ws', { since: readString(input?.since) }),
+                poll: ntfy.buildSubscribeUrl(topic, 'json', { poll: true, since: readString(input?.since) }),
+            },
+        };
+    }
+    if (operation === 'poll' && surface === 'ntfy') {
+        const topic = readString(input?.topic) ?? String(context.deps.configManager.get('surfaces.ntfy.topic') || '');
+        if (!topic)
+            return { surface, ok: false, error: 'topic is required.' };
+        const ntfy = new NtfyIntegration(String(context.deps.configManager.get('surfaces.ntfy.baseUrl') || 'https://ntfy.sh'), await resolveNtfyToken(context.deps) ?? undefined);
+        const messages = await ntfy.poll(topic, { since: readString(input?.since) ?? 'latest' });
+        return { surface, ok: true, messages };
+    }
+    return { surface, ok: false, error: `Unsupported provider operation: ${operation}` };
+}
+async function runProviderSetupAction(context, surface, action, base, account, input) {
+    if (surface === 'slack') {
+        const clientId = readString(input?.clientId) ?? process.env.SLACK_CLIENT_ID;
+        const clientSecret = readString(input?.clientSecret) ?? process.env.SLACK_CLIENT_SECRET;
+        const code = readString(input?.code);
+        const redirectUri = readString(input?.redirectUri);
+        if (code && clientId && clientSecret) {
+            const exchange = await new SlackIntegration().exchangeOAuthCode({ clientId, clientSecret, code, ...(redirectUri ? { redirectUri } : {}) });
+            if (exchange.ok && exchange.access_token) {
+                await context.deps.secretsManager.set('SLACK_BOT_TOKEN', exchange.access_token, { scope: readSecretScope(input?.secretScope) });
+                context.deps.configManager.set('surfaces.slack.enabled', true);
+                if (exchange.team?.id)
+                    context.deps.configManager.set('surfaces.slack.workspaceId', exchange.team.id);
+                const refreshed = await context.buildAccount('slack');
+                return {
+                    ...base,
+                    ok: true,
+                    account: refreshed,
+                    state: refreshed.state,
+                    authState: refreshed.authState,
+                    login: { kind: 'none' },
+                    message: 'Slack OAuth code exchanged and bot token stored in the GoodVibes secret store.',
+                    metadata: { oauth: true, team: exchange.team ?? null },
+                };
+            }
+            return {
+                ...base,
+                ok: false,
+                login: { kind: 'none' },
+                message: `Slack OAuth exchange failed: ${exchange.error ?? 'unknown error'}`,
+                metadata: { oauth: true, exchange },
+            };
+        }
+        if (clientId) {
+            return {
+                ...base,
+                ok: true,
+                login: {
+                    kind: 'browser',
+                    url: SlackIntegration.buildOAuthAuthorizeUrl({
+                        clientId,
+                        redirectUri,
+                        scopes: readStringList(input?.scopes) ?? ['commands', 'chat:write', 'channels:read', 'groups:read', 'im:read', 'mpim:read', 'users:read'],
+                        state: readString(input?.state),
+                        teamId: readString(input?.teamId),
+                    }),
+                    instructions: 'Open this Slack install URL, approve the app, then rerun login with the returned code plus clientSecret.',
+                },
+                message: 'Slack OAuth install URL generated.',
+                metadata: { oauth: true, requiresCodeExchange: true },
+            };
+        }
+    }
+    if (surface === 'discord') {
+        const botToken = readString(input?.botToken);
+        if (botToken) {
+            await context.deps.secretsManager.set('DISCORD_BOT_TOKEN', botToken, { scope: readSecretScope(input?.secretScope) });
+            context.deps.configManager.set('surfaces.discord.enabled', true);
+        }
+        const configuredApplicationId = String(context.deps.configManager.get('surfaces.discord.applicationId') || '');
+        const applicationId = (readString(input?.applicationId) ?? configuredApplicationId) || process.env.DISCORD_APPLICATION_ID;
+        const guildId = readString(input?.guildId);
+        if (readString(input?.applicationId))
+            context.deps.configManager.set('surfaces.discord.applicationId', readString(input?.applicationId));
+        if (guildId)
+            context.deps.configManager.set('surfaces.discord.guildId', guildId);
+        if (readString(input?.defaultChannelId))
+            context.deps.configManager.set('surfaces.discord.defaultChannelId', readString(input?.defaultChannelId));
+        const refreshed = await context.buildAccount('discord');
+        return {
+            ...base,
+            ok: Boolean(botToken || applicationId),
+            account: refreshed,
+            state: refreshed.state,
+            authState: refreshed.authState,
+            login: applicationId
+                ? {
+                    kind: 'browser',
+                    url: DiscordIntegration.buildOAuthAuthorizeUrl({
+                        clientId: applicationId,
+                        guildId,
+                        permissions: readString(input?.permissions) ?? '2048',
+                        scopes: readStringList(input?.scopes) ?? ['bot', 'applications.commands'],
+                        disableGuildSelect: typeof input?.disableGuildSelect === 'boolean' ? input.disableGuildSelect : undefined,
+                        state: readString(input?.state),
+                    }),
+                    instructions: 'Open this Discord install URL to add the bot and slash commands to a server.',
+                }
+                : { kind: 'manual', instructions: 'Provide applicationId and botToken to complete Discord setup.' },
+            message: botToken ? 'Discord bot token stored in the GoodVibes secret store.' : 'Discord install URL generated.',
+            metadata: { oauth: true, applicationId: applicationId ?? null },
+        };
+    }
+    if (surface === 'ntfy') {
+        const topic = readString(input?.topic);
+        const token = readString(input?.token);
+        const baseUrl = readString(input?.baseUrl);
+        if (topic)
+            context.deps.configManager.set('surfaces.ntfy.topic', topic);
+        if (baseUrl)
+            context.deps.configManager.set('surfaces.ntfy.baseUrl', baseUrl);
+        if (token)
+            await context.deps.secretsManager.set('NTFY_ACCESS_TOKEN', token, { scope: readSecretScope(input?.secretScope) });
+        context.deps.configManager.set('surfaces.ntfy.enabled', true);
+        const refreshed = await context.buildAccount('ntfy');
+        return {
+            ...base,
+            ok: Boolean(topic || account.configured),
+            account: refreshed,
+            state: refreshed.state,
+            authState: refreshed.authState,
+            login: { kind: 'none' },
+            message: token || topic ? 'ntfy configuration stored.' : 'ntfy is config-backed; provide topic and optional token to configure it.',
+            metadata: { topic: topic ?? context.deps.configManager.get('surfaces.ntfy.topic') },
+        };
+    }
+    return {
+        ...base,
+        ok: account.linked,
+        login: { kind: 'manual', instructions: 'No provider-native setup flow is available for this surface.' },
+        message: `${surface} provider setup is not supported.`,
+        metadata: { providerNative: false, action },
+    };
+}
+async function runProviderLogoutAction(context, surface, action, base, account, input) {
+    const confirmed = input?.confirm === true || input?.removeSecrets === true;
+    if (!confirmed) {
+        return {
+            ...base,
+            ok: false,
+            message: 'Credential removal requires confirm:true or removeSecrets:true because environment-backed secrets cannot be restored by GoodVibes.',
+            metadata: { requiresConfirmation: true, linked: account.linked },
+        };
+    }
+    if (context.deps.providerRuntime)
+        context.deps.providerRuntime.stop(surface);
+    const secrets = context.deps.secretsManager;
+    if (surface === 'slack') {
+        await secrets.delete('SLACK_BOT_TOKEN');
+        await secrets.delete('SLACK_APP_TOKEN');
+        context.deps.configManager.set('surfaces.slack.botToken', '');
+        context.deps.configManager.set('surfaces.slack.appToken', '');
+    }
+    else if (surface === 'discord') {
+        await secrets.delete('DISCORD_BOT_TOKEN');
+        context.deps.configManager.set('surfaces.discord.botToken', '');
+    }
+    else {
+        await secrets.delete('NTFY_ACCESS_TOKEN');
+        context.deps.configManager.set('surfaces.ntfy.token', '');
+    }
+    const refreshed = await context.buildAccount(surface);
+    return {
+        ...base,
+        ok: true,
+        account: refreshed,
+        state: refreshed.state,
+        authState: refreshed.authState,
+        message: `${surface} GoodVibes-managed credentials removed. Environment variables, if present, still take precedence.`,
+        metadata: { action, envBacked: providerEnvBacked(surface) },
+    };
+}