@zihanw/pi-forge 0.4.0-beta.1 → 0.4.1

package/dist/web-editor/types.d.ts

@@ -1,6 +1,10 @@
+import type { AgentProfile, AgentProfileDiagnostic } from "../agent-profile.ts";
+import type { AgentProfilePreview, AgentProfileRuntimeStatus } from "../profile-service.ts";
 import type { PromptStack, PromptStackDiagnostic } from "../types.ts";
 export interface WebEditorStackSummary {
     id: string;
+    selector: string;
+    scope: "global" | "project";
     name?: string;
     filePath: string;
     active: boolean;
@@ -14,6 +18,14 @@ export interface WebEditorStackSummary {
 export interface WebEditorHost {
     cwd: string;
     listStacks(): WebEditorStackSummary[];
+    listProfiles(): WebEditorProfileCollection;
+    reloadProfiles(): Promise<WebEditorOperationResult<WebEditorProfileCollection>>;
+    validateProfile(profile: AgentProfile, existingId?: string, scope?: "global" | "project"): WebEditorProfileValidation;
+    createProfile(profile: AgentProfile, scope?: "global" | "project"): Promise<WebEditorOperationResult<WebEditorProfileMutation>>;
+    saveProfile(id: string, profile: AgentProfile): Promise<WebEditorOperationResult<WebEditorProfileMutation>>;
+    applyProfile(id: string): Promise<WebEditorOperationResult<WebEditorProfileMutation>>;
+    deleteProfile(id: string): Promise<WebEditorOperationResult<WebEditorProfileMutation>>;
+    updateSubagentPolicy(id: string, update: WebEditorSubagentPolicyUpdate): Promise<WebEditorOperationResult<WebEditorProfileMutation>>;
     listResources(): WebEditorPolicyResources;
     getStack(id: string): {
         stack: PromptStack;
@@ -54,6 +66,79 @@ export interface WebEditorHost {
         stacks: WebEditorStackSummary[];
     }>>;
 }
+export interface WebEditorProfileEntry {
+    profile: AgentProfile;
+    filePath: string;
+    selector: string;
+    scope: "global" | "project";
+    preview: AgentProfilePreview;
+    errors: number;
+    warnings: number;
+    lastApplied: boolean;
+    subagent: WebEditorSubagentProfilePolicy;
+}
+export interface WebEditorSubagentBackendOption {
+    id: string;
+    version: string;
+}
+export interface WebEditorSubagentProfilePolicy {
+    enabled: boolean;
+    enabledSource: "project-profile" | "global-profile" | "built-in";
+    backend: string;
+    backendSource: string;
+    backendRegistered: boolean;
+    timeoutMs: number;
+    timeoutSource: string;
+    configured: {
+        enabled?: boolean;
+        backend?: string;
+        timeoutMs?: number;
+    };
+}
+export interface WebEditorSubagentSummary {
+    defaultBackend: string;
+    defaultBackendSource: string;
+    timeoutMs: number;
+    timeoutSource: string;
+    allowAgentInvocationWithoutApproval: boolean;
+    backends: WebEditorSubagentBackendOption[];
+    warnings: string[];
+}
+export interface WebEditorSubagentPolicyUpdate {
+    enabled?: boolean;
+    backend?: string | null;
+    timeoutMs?: number | null;
+}
+export interface WebEditorProfileCollection {
+    trusted: boolean;
+    profileDirectory: string;
+    profiles: WebEditorProfileEntry[];
+    status: AgentProfileRuntimeStatus;
+    models: WebEditorProfileModelOption[];
+    promptStacks: Array<{
+        id: string;
+        name?: string;
+        selector: string;
+        scope: "global" | "project";
+    }>;
+    subagents: WebEditorSubagentSummary;
+}
+export interface WebEditorProfileModelOption {
+    provider: string;
+    id: string;
+    name?: string;
+    available: boolean;
+}
+export interface WebEditorProfileValidation {
+    preview: AgentProfilePreview;
+    diagnostics: AgentProfileDiagnostic[];
+    errors: number;
+    warnings: number;
+}
+export interface WebEditorProfileMutation {
+    collection: WebEditorProfileCollection;
+    selectedPath: string;
+}
 export interface WebEditorPreviewSection {
     id: string;
     title: string;
@@ -94,6 +179,8 @@ export type WebEditorPayloadSnapshot = {
 export interface WebEditorCreateStackOptions {
     activate?: boolean;
     overwrite?: boolean;
+    /** Explicit target scope. Defaults to project for unqualified web create routes. */
+    scope?: "global" | "project";
 }
 export interface WebEditorPolicyResource {
     name: string;

package/dist/web-editor/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-editor/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-editor/types.ts"],"names":[],"mappings":"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"}

package/dist/web-host.d.ts

@@ -1,6 +1,8 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { LoadedPromptStack, PromptStackDiagnostic } from "./types.ts";
-import type { WebEditorHost, WebEditorOperationResult, WebEditorPayloadSnapshot, WebEditorPolicyResources, WebEditorPreview, WebEditorStackSummary } from "./web-editor/index.ts";
+import { type AgentProfileProvenance, type LoadedAgentProfile, type ResolvedAgentProfile } from "./agent-profile.ts";
+import { type AgentProfileApplicationResult, type AgentProfileCurrentRuntime } from "./profile-service.ts";
+import type { LoadedPromptStack, PromptStack, PromptStackDiagnostic } from "./types.ts";
+import type { WebEditorHost, WebEditorOperationResult, WebEditorPayloadSnapshot, WebEditorPolicyResources, WebEditorPreview, WebEditorStackSummary, WebEditorSubagentBackendOption } from "./web-editor/index.ts";
 export interface WebHostRuntime {
     getStacks(): LoadedPromptStack[];
     getActive(): LoadedPromptStack | undefined;
@@ -14,6 +16,15 @@ export interface WebHostRuntime {
         diagnostics: PromptStackDiagnostic[];
     };
     getPolicyResources(): WebEditorPolicyResources;
+    getProfiles(): LoadedAgentProfile[];
+    getLastAppliedProfile(): AgentProfileProvenance | undefined;
+    getCurrentProfileRuntime(): AgentProfileCurrentRuntime;
+    getSubagentBackends(): WebEditorSubagentBackendOption[];
+    resolveProfile(target: LoadedAgentProfile): ResolvedAgentProfile;
+    previewToolNames(stack: PromptStack | undefined): string[];
+    reloadProfiles(): void | Promise<void>;
+    isIdle(): boolean;
+    applyProfile(target: ResolvedAgentProfile): Promise<AgentProfileApplicationResult>;
     getPayload(): WebEditorOperationResult<WebEditorPayloadSnapshot>;
     armPayload(savePath?: string): WebEditorOperationResult<WebEditorPayloadSnapshot>;
     clearPayload(): WebEditorOperationResult<WebEditorPayloadSnapshot>;

package/dist/web-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-host.d.ts","sourceRoot":"","sources":["../src/web-host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAMxE,OAAO,KAAK,EAAE,iBAAiB,EAAe,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAEX,aAAa,EACb,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC9B,SAAS,IAAI,iBAAiB,EAAE,CAAC;IACjC,SAAS,IAAI,iBAAiB,GAAG,SAAS,CAAC;IAC3C,WAAW,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3C,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG;QACxC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,gBAAgB,CAAC;QAC1B,WAAW,EAAE,qBAAqB,EAAE,CAAC;KACrC,CAAC;IACF,kBAAkB,IAAI,wBAAwB,CAAC;IAC/C,UAAU,IAAI,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;IACjE,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;IAClF,YAAY,IAAI,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;CACnE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAoCjG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,qBAAqB,CAepH;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,qBAAqB,EAAE,CAE1H;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAmC/H"}
+{"version":3,"file":"web-host.d.ts","sourceRoot":"","sources":["../src/web-host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAON,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,MAAM,oBAAoB,CAAC;AAoB5B,OAAO,EAKN,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAEX,aAAa,EACb,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAIhB,qBAAqB,EACrB,8BAA8B,EAG9B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC9B,SAAS,IAAI,iBAAiB,EAAE,CAAC;IACjC,SAAS,IAAI,iBAAiB,GAAG,SAAS,CAAC;IAC3C,WAAW,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3C,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG;QACxC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,gBAAgB,CAAC;QAC1B,WAAW,EAAE,qBAAqB,EAAE,CAAC;KACrC,CAAC;IACF,kBAAkB,IAAI,wBAAwB,CAAC;IAC/C,WAAW,IAAI,kBAAkB,EAAE,CAAC;IACpC,qBAAqB,IAAI,sBAAsB,GAAG,SAAS,CAAC;IAC5D,wBAAwB,IAAI,0BAA0B,CAAC;IACvD,mBAAmB,IAAI,8BAA8B,EAAE,CAAC;IACxD,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACjE,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3D,cAAc,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,OAAO,CAAC;IAClB,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACnF,UAAU,IAAI,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;IACjE,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;IAClF,YAAY,IAAI,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;CACnE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CA+CjG;AAwWD,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,qBAAqB,CAiBpH;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,qBAAqB,EAAE,CAE1H;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAmC/H"}

package/dist/web-host.js

@@ -1,13 +1,30 @@
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { isInsidePromptStackStorage, promptStackPath, validatePromptStack, } from "./loader.js";
+import { agentProfilePath, agentProfilesDir, isResolvedAgentProfileUsable, validateAgentProfile, validateAgentProfilePromptStackScope, } from "./agent-profile.js";
+import { DEFAULT_SUBAGENT_BACKEND_ID, loadForgeSubagentSettings, resolveSubagentProfilePolicy, updateForgeSubagentProfileConfig, } from "./forge-config.js";
+import { isSafeGlobalPromptStackMutationPath, isSafePromptStackMutationPath, isValidPromptStackId, promptStackPath, validatePromptStack, } from "./loader.js";
+import { globalAgentProfilePath, globalPromptStacksDir } from "./storage.js";
+import { formatResourceKey, parseResourceSelector } from "./resource-identity.js";
+import { resolveResourceSelector } from "./catalog.js";
+import { createAgentProfilePreview, deleteAgentProfile, getAgentProfileRuntimeStatus, writeAgentProfile, } from "./profile-service.js";
 export function createWebEditorHost(ctx, runtime) {
     return {
         cwd: ctx.cwd,
         listStacks: () => stackSummaries(runtime.getStacks(), runtime.getActive()),
+        listProfiles: () => profileCollection(ctx, runtime),
+        reloadProfiles: async () => {
+            await runtime.reloadProfiles();
+            return { ok: true, ...profileCollection(ctx, runtime) };
+        },
+        validateProfile: (profile, existingId, scope) => profileValidation(ctx, runtime, profile, existingId, scope),
+        createProfile: (profile, scope) => createProfileFile(ctx, runtime, profile, scope),
+        saveProfile: (selector, profile) => saveProfileFile(ctx, runtime, selector, profile),
+        applyProfile: (selector) => applyProfileRuntime(ctx, runtime, selector),
+        deleteProfile: (selector) => deleteProfileFile(ctx, runtime, selector),
+        updateSubagentPolicy: (selector, update) => updateSubagentPolicy(ctx, runtime, selector, update),
         listResources: () => runtime.getPolicyResources(),
-        getStack: (id) => {
-            const loaded = runtime.getStacks().find((candidate) => candidate.stack.id === id);
+        getStack: (selector) => {
+            const loaded = resolveStack(runtime, selector);
             return loaded ? { stack: loaded.stack, filePath: loaded.filePath, diagnostics: loaded.diagnostics } : undefined;
         },
         createStack: (stack, options) => createStackFile(ctx, runtime, stack, options),
@@ -15,19 +32,19 @@ export function createWebEditorHost(ctx, runtime) {
         deleteStack: (id) => deleteStackFile(ctx, runtime, id),
         validateStack: (stack) => validatePromptStack(stack),
         previewStack: (id, stack) => {
-            const target = runtime.getStacks().find((candidate) => candidate.stack.id === id);
+            const target = resolveStack(runtime, id);
             if (!target)
                 return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
             const diagnostics = validatePromptStack(stack);
-            const preview = runtime.buildPreview({ stack, filePath: target.filePath, diagnostics });
+            const preview = runtime.buildPreview({ stack, filePath: target.filePath, scope: target.scope, key: target.key, diagnostics });
             return { ok: true, text: preview.text, preview: preview.preview, diagnostics: preview.diagnostics };
         },
         getPayload: () => runtime.getPayload(),
         armPayload: (savePath) => runtime.armPayload(savePath),
         clearPayload: () => runtime.clearPayload(),
-        activateStack: (id) => {
-            if (!runtime.setActive(id))
-                return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
+        activateStack: (selector) => {
+            if (!runtime.setActive(selector))
+                return { ok: false, status: 404, error: `Unknown prompt stack: ${selector}` };
             return { ok: true, activeId: runtime.getActiveId(), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
         },
         disableStacks: () => {
@@ -40,11 +57,322 @@ export function createWebEditorHost(ctx, runtime) {
         },
     };
 }
+/** Unqualified selectors address project profiles only; global profiles require `global:<id>`. */
+function resolveProfilesForMutation(runtime, selector) {
+    const parsed = parseResourceSelector(selector);
+    if (!parsed.ok)
+        return [];
+    const scope = parsed.selector.scope ?? "project";
+    return runtime.getProfiles().filter((loaded) => loaded.scope === scope && loaded.profile.id === parsed.selector.id);
+}
+function profileCollection(ctx, runtime) {
+    const profiles = runtime.getProfiles();
+    const current = runtime.getCurrentProfileRuntime();
+    const lastApplied = runtime.getLastAppliedProfile();
+    const availableModels = new Set(ctx.modelRegistry.getAvailable().map((model) => modelKey(model.provider, model.id)));
+    const subagentSettings = loadForgeSubagentSettings(ctx);
+    const subagentBackends = runtime.getSubagentBackends();
+    const registeredBackends = new Set(subagentBackends.map((backend) => backend.id));
+    return {
+        trusted: ctx.isProjectTrusted(),
+        profileDirectory: agentProfilesDir(ctx.cwd),
+        profiles: profiles.map((loaded) => {
+            const resolved = runtime.resolveProfile(loaded);
+            const targetEffectiveTools = resolved.promptStack || resolved.loaded.profile.promptStack === null
+                ? runtime.previewToolNames(resolved.promptStack?.stack)
+                : [];
+            const preview = createAgentProfilePreview(resolved, current, targetEffectiveTools);
+            return {
+                profile: structuredClone(loaded.profile),
+                filePath: loaded.filePath,
+                selector: formatResourceKey(loaded.key),
+                scope: loaded.scope,
+                preview,
+                errors: preview.diagnostics.filter((diagnostic) => diagnostic.level === "error").length,
+                warnings: preview.diagnostics.filter((diagnostic) => diagnostic.level === "warning").length,
+                lastApplied: lastApplied?.sourcePath === loaded.filePath,
+                subagent: subagentPolicySummary(subagentSettings, loaded, registeredBackends),
+            };
+        }),
+        status: getAgentProfileRuntimeStatus(profiles, lastApplied, current),
+        models: ctx.modelRegistry.getAll().map((model) => ({
+            provider: model.provider,
+            id: model.id,
+            name: model.name,
+            available: availableModels.has(modelKey(model.provider, model.id)),
+        })),
+        promptStacks: runtime.getStacks().map((loaded) => ({
+            id: loaded.stack.id,
+            name: loaded.stack.name,
+            selector: formatResourceKey(loaded.key),
+            scope: loaded.scope,
+        })),
+        subagents: {
+            defaultBackend: subagentSettings.backend ?? DEFAULT_SUBAGENT_BACKEND_ID,
+            defaultBackendSource: subagentSettings.backendSource ?? "built-in",
+            timeoutMs: subagentSettings.timeoutMs,
+            timeoutSource: subagentSettings.timeoutSource,
+            allowAgentInvocationWithoutApproval: subagentSettings.allowAgentInvocationWithoutApproval,
+            backends: subagentBackends,
+            warnings: [...subagentSettings.warnings],
+        },
+    };
+}
+function subagentPolicySummary(settings, loaded, registeredBackends) {
+    const selector = formatResourceKey(loaded.key);
+    const policy = resolveSubagentProfilePolicy(settings, selector);
+    const configured = settings.profiles[selector];
+    return {
+        enabled: policy.enabled,
+        enabledSource: policy.enabledSource,
+        backend: policy.backend.id,
+        backendSource: policy.backend.source,
+        backendRegistered: registeredBackends.has(policy.backend.id),
+        timeoutMs: policy.timeout.milliseconds,
+        timeoutSource: policy.timeout.source,
+        configured: configuredSubagentProfile(configured),
+    };
+}
+function configuredSubagentProfile(configured) {
+    if (!configured)
+        return {};
+    return {
+        enabled: configured.enabled,
+        backend: configured.backend,
+        timeoutMs: configured.timeoutMs,
+    };
+}
+function profileValidation(ctx, runtime, profile, existingId, validationScope) {
+    const profiles = runtime.getProfiles();
+    const existingSelector = existingId ? parseResourceSelector(existingId) : undefined;
+    const existingMatches = existingSelector?.ok
+        ? profiles.filter((loaded) => loaded.scope === (existingSelector.selector.scope ?? "project") && loaded.profile.id === existingSelector.selector.id)
+        : [];
+    const existing = existingMatches.length === 1 ? existingMatches[0] : undefined;
+    const scope = existing?.scope ?? validationScope ?? "project";
+    const filePath = existing?.filePath ?? (scope === "global" ? globalAgentProfilePath(profile.id) : agentProfilePath(ctx.cwd, profile.id));
+    const diagnostics = [
+        ...validateAgentProfile(profile),
+        ...validateAgentProfilePromptStackScope(profile, scope),
+    ];
+    const otherProfiles = existing
+        ? profiles.filter((loaded) => loaded.scope === scope && loaded.filePath !== filePath)
+        : profiles.filter((loaded) => loaded.scope === scope);
+    if (otherProfiles.some((loaded) => loaded.profile.id === profile.id)) {
+        diagnostics.push({
+            level: "error",
+            field: "id",
+            message: `Duplicate profile id: ${profile.id} already exists in another file.`,
+        });
+    }
+    if (!existing && existsSync(filePath)) {
+        diagnostics.push({
+            level: "error",
+            field: "id",
+            message: `Profile file already exists: ${filePath}`,
+        });
+    }
+    if (profile.autoActivate && otherProfiles.some((loaded) => loaded.profile.autoActivate === true)) {
+        diagnostics.push({
+            level: "error",
+            field: "autoActivate",
+            message: "Multiple profiles request auto-activation; exactly one is allowed.",
+        });
+    }
+    const resolved = runtime.resolveProfile({ profile, filePath, scope, key: { scope, id: profile.id }, diagnostics });
+    const targetEffectiveTools = resolved.promptStack || profile.promptStack === null
+        ? runtime.previewToolNames(resolved.promptStack?.stack)
+        : [];
+    const preview = createAgentProfilePreview(resolved, runtime.getCurrentProfileRuntime(), targetEffectiveTools);
+    return {
+        preview,
+        diagnostics: preview.diagnostics,
+        errors: preview.diagnostics.filter((diagnostic) => diagnostic.level === "error").length,
+        warnings: preview.diagnostics.filter((diagnostic) => diagnostic.level === "warning").length,
+    };
+}
+async function createProfileFile(ctx, runtime, profile, scope = "project") {
+    if (!ctx.isProjectTrusted()) {
+        return { ok: false, status: 403, error: "Project is not trusted; refusing to create agent profiles." };
+    }
+    if (runtime.getProfiles().some((loaded) => loaded.scope === scope && loaded.profile.id === profile.id)) {
+        return { ok: false, status: 409, error: `Agent profile already exists: ${profile.id}` };
+    }
+    const conflict = autoActivateConflictError(runtime.getProfiles(), profile, scope);
+    if (conflict)
+        return { ok: false, status: 409, error: conflict };
+    const result = writeAgentProfile(ctx.cwd, profile, { scope });
+    if (!result.ok)
+        return profileWriteError(profile.id, result);
+    await runtime.reloadProfiles();
+    return {
+        ok: true,
+        collection: profileCollection(ctx, runtime),
+        selectedPath: result.filePath,
+    };
+}
+async function saveProfileFile(ctx, runtime, id, profile) {
+    if (!ctx.isProjectTrusted()) {
+        return { ok: false, status: 403, error: "Project is not trusted; refusing to save agent profiles." };
+    }
+    const matches = resolveProfilesForMutation(runtime, id);
+    if (matches.length === 0)
+        return { ok: false, status: 404, error: `Unknown agent profile: ${id}` };
+    if (matches.length > 1) {
+        return { ok: false, status: 409, error: `Cannot save agent profile ${id} while duplicate profile ids exist.` };
+    }
+    if (profile.id !== matches[0].profile.id) {
+        return { ok: false, status: 400, error: "Profile id is immutable during save; create a new profile to use a different id." };
+    }
+    const conflict = autoActivateConflictError(runtime.getProfiles(), profile, matches[0].scope, matches[0].profile.id);
+    if (conflict)
+        return { ok: false, status: 409, error: conflict };
+    const result = writeAgentProfile(ctx.cwd, profile, {
+        filePath: matches[0].filePath,
+        overwrite: true,
+        scope: matches[0].scope,
+    });
+    if (!result.ok)
+        return profileWriteError(id, result);
+    await runtime.reloadProfiles();
+    return {
+        ok: true,
+        collection: profileCollection(ctx, runtime),
+        selectedPath: result.filePath,
+    };
+}
+async function updateSubagentPolicy(ctx, runtime, id, update) {
+    if (!ctx.isProjectTrusted()) {
+        return { ok: false, status: 403, error: "Project is not trusted; refusing to change subagent delegation." };
+    }
+    const matches = resolveProfilesForMutation(runtime, id);
+    if (matches.length === 0)
+        return { ok: false, status: 404, error: `Unknown agent profile: ${id}` };
+    if (matches.length > 1) {
+        return { ok: false, status: 409, error: `Cannot configure subagent delegation for ${id} while duplicate profile ids exist.` };
+    }
+    const result = updateForgeSubagentProfileConfig(ctx.cwd, matches[0].profile.id, update, { scope: matches[0].scope });
+    if (!result.ok)
+        return { ok: false, status: 400, error: result.error };
+    return {
+        ok: true,
+        collection: profileCollection(ctx, runtime),
+        selectedPath: matches[0].filePath,
+    };
+}
+function autoActivateConflictError(profiles, profile, scope, excludeId) {
+    if (profile.autoActivate !== true)
+        return undefined;
+    const conflict = profiles.find((loaded) => loaded.scope === scope && loaded.profile.autoActivate === true && loaded.profile.id !== excludeId);
+    return conflict
+        ? `Multiple ${scope} profiles request auto-activation; exactly one is allowed (already requested by ${conflict.profile.id}).`
+        : undefined;
+}
+async function applyProfileRuntime(ctx, runtime, id) {
+    if (!ctx.isProjectTrusted()) {
+        return { ok: false, status: 403, error: "Project is not trusted; refusing to apply agent profiles." };
+    }
+    if (!runtime.isIdle()) {
+        return { ok: false, status: 409, error: "Wait for the current agent operation to finish before applying a profile." };
+    }
+    const matches = resolveProfilesForMutation(runtime, id);
+    if (matches.length === 0)
+        return { ok: false, status: 404, error: `Unknown agent profile: ${id}` };
+    if (matches.length > 1) {
+        return { ok: false, status: 409, error: `Cannot apply agent profile ${id} while duplicate profile ids exist.` };
+    }
+    const resolved = runtime.resolveProfile(matches[0]);
+    if (!isResolvedAgentProfileUsable(resolved) || !resolved.model) {
+        return { ok: false, status: 400, error: `Agent profile ${id} failed preflight; runtime state was not changed.` };
+    }
+    const result = await runtime.applyProfile(resolved);
+    if (!result.ok) {
+        const rollback = result.rollbackErrors.length
+            ? ` Rollback problems: ${result.rollbackErrors.join("; ")}.`
+            : " Previous runtime state was restored.";
+        return { ok: false, status: 500, error: `${result.detail}${result.detail.endsWith(".") ? "" : "."}${rollback}` };
+    }
+    return {
+        ok: true,
+        collection: profileCollection(ctx, runtime),
+        selectedPath: matches[0].filePath,
+    };
+}
+async function deleteProfileFile(ctx, runtime, id) {
+    if (!ctx.isProjectTrusted()) {
+        return { ok: false, status: 403, error: "Project is not trusted; refusing to delete agent profiles." };
+    }
+    const matches = resolveProfilesForMutation(runtime, id);
+    if (matches.length === 0)
+        return { ok: false, status: 404, error: `Unknown agent profile: ${id}` };
+    if (matches.length > 1) {
+        return { ok: false, status: 409, error: `Cannot delete agent profile ${id} while duplicate profile ids exist.` };
+    }
+    const subagentSettings = loadForgeSubagentSettings(ctx);
+    const result = deleteAgentProfile(ctx.cwd, matches[0]);
+    if (!result.ok) {
+        if (result.reason === "invalid-path")
+            return { ok: false, status: 403, error: "Refusing to delete outside agent-profile storage." };
+        if (result.reason === "missing")
+            return { ok: false, status: 404, error: `Agent profile file is missing: ${result.filePath}` };
+        if (result.reason === "changed") {
+            return { ok: false, status: 409, error: `Agent profile ${id} changed on disk; refresh before deleting it.` };
+        }
+        return { ok: false, status: 500, error: result.error ?? `Failed to delete agent profile ${id}.` };
+    }
+    if (Object.hasOwn(subagentSettings.profiles, formatResourceKey(matches[0].key))) {
+        const cleared = updateForgeSubagentProfileConfig(ctx.cwd, matches[0].profile.id, {
+            enabled: false,
+            backend: null,
+            timeoutMs: null,
+        }, { scope: matches[0].scope });
+        if (!cleared.ok) {
+            await runtime.reloadProfiles();
+            return {
+                ok: false,
+                status: 500,
+                error: `Deleted agent profile ${id}, but failed to remove its delegation settings: ${cleared.error}`,
+            };
+        }
+    }
+    await runtime.reloadProfiles();
+    const collection = profileCollection(ctx, runtime);
+    return {
+        ok: true,
+        collection,
+        selectedPath: collection.profiles[0]?.filePath ?? "",
+    };
+}
+function profileWriteError(id, result) {
+    if (result.reason === "exists")
+        return { ok: false, status: 409, error: `Agent profile already exists: ${id}` };
+    if (result.reason === "invalid-path")
+        return { ok: false, status: 403, error: result.error ?? "Refusing to write outside agent-profile storage." };
+    if (result.reason === "validation") {
+        return {
+            ok: false,
+            status: 400,
+            error: result.diagnostics.map((diagnostic) => diagnostic.message).join(" "),
+        };
+    }
+    return { ok: false, status: 500, error: result.error ?? `Failed to write agent profile ${id}.` };
+}
+function modelKey(provider, id) {
+    return `${provider}\0${id}`;
+}
+function resolveStack(runtime, selector) {
+    const parsed = parseResourceSelector(selector);
+    if (!parsed.ok)
+        return undefined;
+    return resolveResourceSelector(runtime.getStacks(), parsed.selector);
+}
 export function stackSummary(loaded, active) {
     const errors = loaded.diagnostics.filter((d) => d.level === "error").length;
     const warnings = loaded.diagnostics.filter((d) => d.level === "warning").length;
     return {
         id: loaded.stack.id,
+        selector: formatResourceKey(loaded.key),
+        scope: loaded.scope,
         name: loaded.stack.name,
         filePath: loaded.filePath,
         active: loaded === active,
@@ -96,22 +424,26 @@ async function saveStackFile(ctx, runtime, id, stack) {
     if (!ctx.isProjectTrusted()) {
         return { ok: false, status: 403, error: "Project is not trusted; refusing to save prompt stacks." };
     }
-    const target = runtime.getStacks().find((candidate) => candidate.stack.id === id);
+    const target = resolveStack(runtime, id);
     if (!target)
         return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
     const idError = validateWebStackId(stack.id);
     if (idError)
         return { ok: false, status: 400, error: idError };
-    if (stack.id !== id) {
+    if (stack.id !== target.stack.id) {
         return { ok: false, status: 400, error: "Stack id is immutable during save; fork the stack to create a new id." };
     }
-    if (!isInsidePromptStackStorage(ctx.cwd, target.filePath)) {
-        return { ok: false, status: 403, error: "Refusing to save outside prompt-stack storage." };
+    const safe = target.scope === "project"
+        ? isSafePromptStackMutationPath(ctx.cwd, target.filePath)
+        : isSafeGlobalPromptStackMutationPath(target.filePath);
+    if (!safe) {
+        return { ok: false, status: 403, error: "Refusing to save outside prompt-stack storage or through a symbolic link." };
     }
     writeFileSync(target.filePath, `${JSON.stringify(stack, null, 2)}\n`, "utf8");
-    const preferredId = runtime.getActive()?.stack.id === id ? stack.id : runtime.getSelectedActiveId();
+    const preferredId = runtime.getActive() === target ? formatResourceKey(target.key) : runtime.getSelectedActiveId();
     await runtime.reloadStacks(preferredId);
-    const saved = runtime.getStacks().find((candidate) => candidate.stack.id === stack.id) ?? runtime.getStacks().find((candidate) => candidate.filePath === target.filePath);
+    const saved = runtime.getStacks().find((candidate) => candidate.scope === target.scope && candidate.stack.id === target.stack.id)
+        ?? runtime.getStacks().find((candidate) => candidate.filePath === target.filePath);
     if (!saved)
         return { ok: false, status: 500, error: "Saved stack could not be reloaded." };
     return { ok: true, stack: stackSummary(saved, runtime.getActive()), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
@@ -123,24 +455,33 @@ async function createStackFile(ctx, runtime, stack, options) {
     const idError = validateWebStackId(stack.id);
     if (idError)
         return { ok: false, status: 400, error: idError };
-    const existingById = runtime.getStacks().find((candidate) => candidate.stack.id === stack.id);
+    const scope = options.scope ?? "project";
+    const existingById = runtime.getStacks().find((candidate) => candidate.scope === scope && candidate.stack.id === stack.id);
     if (existingById && !options.overwrite) {
         return { ok: false, status: 409, error: `Prompt stack already exists: ${stack.id}` };
     }
-    const targetPath = existingById && options.overwrite ? existingById.filePath : promptStackPath(ctx.cwd, stack.id);
-    if (!isInsidePromptStackStorage(ctx.cwd, targetPath)) {
-        return { ok: false, status: 403, error: "Refusing to create outside prompt-stack storage." };
+    const targetPath = existingById && options.overwrite
+        ? existingById.filePath
+        : scope === "global"
+            ? join(globalPromptStacksDir(), `${stack.id}.json`)
+            : promptStackPath(ctx.cwd, stack.id);
+    const safe = scope === "project"
+        ? isSafePromptStackMutationPath(ctx.cwd, targetPath)
+        : isSafeGlobalPromptStackMutationPath(targetPath);
+    if (!safe) {
+        return { ok: false, status: 403, error: `Refusing to create outside ${scope} prompt-stack storage or through a symbolic link.` };
     }
     if (!existingById && existsSync(targetPath) && !options.overwrite) {
         return { ok: false, status: 409, error: `Prompt stack already exists: ${stack.id}` };
     }
     const previousSelection = runtime.getSelectedActiveId();
+    const createdSelector = formatResourceKey({ scope, id: stack.id });
     mkdirSync(dirname(targetPath), { recursive: true });
     writeFileSync(targetPath, `${JSON.stringify(stack, null, 2)}\n`, "utf8");
-    await runtime.reloadStacks(options.activate ? stack.id : (previousSelection ?? "none"));
+    await runtime.reloadStacks(options.activate ? createdSelector : (previousSelection ?? "none"));
     if (options.activate)
-        runtime.setActive(stack.id);
-    const created = runtime.getStacks().find((candidate) => candidate.stack.id === stack.id);
+        runtime.setActive(createdSelector);
+    const created = runtime.getStacks().find((candidate) => candidate.scope === scope && candidate.filePath === targetPath);
     if (!created)
         return { ok: false, status: 500, error: "Created stack could not be reloaded." };
     return { ok: true, stack: stackSummary(created, runtime.getActive()), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
@@ -149,13 +490,16 @@ async function deleteStackFile(ctx, runtime, id) {
     if (!ctx.isProjectTrusted()) {
         return { ok: false, status: 403, error: "Project is not trusted; refusing to delete prompt stacks." };
     }
-    const target = runtime.getStacks().find((candidate) => candidate.stack.id === id);
+    const target = resolveStack(runtime, id);
     if (!target)
         return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
-    if (!isInsidePromptStackStorage(ctx.cwd, target.filePath)) {
-        return { ok: false, status: 403, error: "Refusing to delete outside prompt-stack storage." };
+    const safe = target.scope === "project"
+        ? isSafePromptStackMutationPath(ctx.cwd, target.filePath)
+        : isSafeGlobalPromptStackMutationPath(target.filePath);
+    if (!safe) {
+        return { ok: false, status: 403, error: "Refusing to delete outside prompt-stack storage or through a symbolic link." };
     }
-    const wasActive = runtime.getActive()?.stack.id === id;
+    const wasActive = runtime.getActive() === target;
     unlinkSync(target.filePath);
     if (wasActive) {
         runtime.setActive("none");
@@ -169,8 +513,8 @@ async function deleteStackFile(ctx, runtime, id) {
 function validateWebStackId(id) {
     if (!id.trim())
         return "Stack id must not be empty.";
-    if (!/^[A-Za-z0-9_-]+$/.test(id)) {
-        return "Stack id may only contain letters, numbers, underscore, and dash.";
+    if (!isValidPromptStackId(id)) {
+        return "Stack id must start with a letter or number and contain only letters, numbers, dots, underscores, and hyphens.";
     }
     return undefined;
 }