@agentxm/client-core 0.1.6

package/dist/src/unstable/subagents/lock-entry-builder.js

@@ -0,0 +1,108 @@
+/**
+ * Maps a SubagentExtensionRef to a SubagentLockEntry for lockfile persistence.
+ *
+ * Follows the same structural pattern as sourceToLockEntry for skills and
+ * buildLockEntryFromRef for commands.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+const optionalField = (key, value) => {
+    const fields = {};
+    if (Option.isSome(value)) {
+        fields[key] = value.value;
+    }
+    return fields;
+};
+const commonFields = (agents, now) => ({
+    agents: [...agents],
+    installedAt: now,
+    updatedAt: now,
+});
+// -----------------------------------------------------------------------------
+// Implementation
+// -----------------------------------------------------------------------------
+/**
+ * Build a SubagentLockEntry from any ref type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const buildSubagentLockEntry = (ref, agents, now) => {
+    const common = commonFields(agents, now);
+    switch (ref.refType) {
+        case "git-hosted": {
+            switch (ref.source.type) {
+                case "github":
+                    return {
+                        type: "github",
+                        owner: ref.source.owner,
+                        repo: ref.source.repo,
+                        ...optionalField("ref", ref.source.ref),
+                        ...optionalField("path", ref.source.subPath),
+                        ...optionalField("gitTreeHash", ref.gitTreeSha),
+                        ...common,
+                    };
+                case "gitlab":
+                    return {
+                        type: "gitlab",
+                        owner: ref.source.owner,
+                        repo: ref.source.repo,
+                        ...optionalField("ref", ref.source.ref),
+                        ...optionalField("path", ref.source.subPath),
+                        ...optionalField("gitTreeHash", ref.gitTreeSha),
+                        ...common,
+                    };
+                case "bitbucket":
+                    return {
+                        type: "bitbucket",
+                        owner: ref.source.owner,
+                        repo: ref.source.repo,
+                        ...optionalField("ref", ref.source.ref),
+                        ...optionalField("path", ref.source.subPath),
+                        ...optionalField("gitTreeHash", ref.gitTreeSha),
+                        ...common,
+                    };
+                case "azurerepos":
+                    return {
+                        type: "azurerepos",
+                        organization: ref.source.organization,
+                        project: ref.source.project,
+                        repo: ref.source.repo,
+                        ...optionalField("ref", ref.source.ref),
+                        ...optionalField("path", ref.source.subPath),
+                        ...optionalField("gitTreeHash", ref.gitTreeSha),
+                        ...common,
+                    };
+                case "git":
+                    return {
+                        type: "git",
+                        url: ref.source.url.href,
+                        ...optionalField("ref", ref.source.ref),
+                        ...optionalField("gitTreeHash", ref.gitTreeSha),
+                        ...common,
+                    };
+            }
+            break;
+        }
+        case "local":
+            return {
+                type: "local",
+                path: ref.source.path,
+                ...common,
+            };
+        case "registry":
+            return {
+                type: "registry",
+                owner: ref.owner,
+                name: ref.subagent.name,
+                resolvedVersion: ref.version,
+                integrity: Option.getOrElse(ref.integrity, () => ""),
+                sourceName: "default",
+                ...common,
+            };
+    }
+};
+//# sourceMappingURL=lock-entry-builder.js.map

package/dist/src/unstable/subagents/lock-entry-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-entry-builder.js","sourceRoot":"","sources":["../../../../src/unstable/subagents/lock-entry-builder.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/subagents/manager.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Subagent extension manager service.
+ *
+ * Implements ExtensionManager<SubagentExtensionRef> with canonical source
+ * materialization, per-agent rendering via CodingAgent.addSubagent(),
+ * and source-hash-based skip logic.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Layer from "effect/Layer";
+import * as ServiceMap from "effect/ServiceMap";
+import type { SubagentExtensionRef } from "./refs.js";
+import type { ExtensionManager } from "../workspace/service-interface.js";
+import { Workspace } from "../workspace/service-interface.js";
+import { CodingAgentRepository } from "../agents/index.js";
+declare const SubagentManager_base: ServiceMap.ServiceClass<SubagentManager, "axm.sh/SubagentManager", ExtensionManager<SubagentExtensionRef>>;
+export declare class SubagentManager extends SubagentManager_base {
+}
+export declare const SubagentManagerLive: Layer.Layer<SubagentManager, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path | Workspace | CodingAgentRepository>;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/unstable/subagents/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/unstable/subagents/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,WAAW,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;;AAmB3D,qBAAa,eAAgB,SAAQ,oBAGR;CAAG;AAMhC,eAAO,MAAM,mBAAmB,mJAyV/B,CAAC"}

package/dist/src/unstable/subagents/manager.js

@@ -0,0 +1,266 @@
+/**
+ * Subagent extension manager service.
+ *
+ * Implements ExtensionManager<SubagentExtensionRef> with canonical source
+ * materialization, per-agent rendering via CodingAgent.addSubagent(),
+ * and source-hash-based skip logic.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+import { makeAppError } from "../app-error/index.js";
+import { Workspace } from "../workspace/service-interface.js";
+import { CodingAgentRepository } from "../agents/index.js";
+import { sanitizeName, copyExtensionDirectory } from "../extensions/utils.js";
+import { removeFromAllCanonicalLocations, stripFileProtocol, computeIntegrity, } from "../utils/index.js";
+import { computeSubagentPaths, SUBAGENT_CONTENT_FILENAME } from "./paths.js";
+import { parseSubagentMd } from "./subagent-content.js";
+import { computeSourceHash, RenderedFilesMapSchema } from "../extensions/rendered-files.js";
+import { validateExactResolvedVersion } from "../lockfile/index.js";
+import { buildSubagentLockEntry } from "./lock-entry-builder.js";
+import { createRegistryClient, extractZip } from "../registry/index.js";
+// -----------------------------------------------------------------------------
+// Service Tag
+// -----------------------------------------------------------------------------
+export class SubagentManager extends ServiceMap.Service()("axm.sh/SubagentManager") {
+}
+// -----------------------------------------------------------------------------
+// Live Layer
+// -----------------------------------------------------------------------------
+export const SubagentManagerLive = Layer.effect(SubagentManager, Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const agentRepo = yield* CodingAgentRepository;
+    const agents = yield* ws.getConfiguredAgents();
+    const baseDir = ws.baseDir;
+    // Build a layer to provide FileSystem + Path to inner effects
+    const fsPathLayer = Layer.mergeAll(Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path));
+    const provide = (effect) => Effect.provide(effect, fsPathLayer);
+    // Compute canonical paths for a subagent ref
+    const getCanonicalPaths = (ref) => {
+        const sanitized = sanitizeName(ref.subagent.name);
+        const source = ref.refType === "registry"
+            ? { refType: "registry", owner: ref.owner }
+            : { refType: ref.refType };
+        const paths = computeSubagentPaths(path.join, baseDir, source, sanitized);
+        return { sanitized, paths };
+    };
+    // Read and parse SUBAGENT.md from canonical source
+    const readSubagentContent = (subagentSrcPath) => Effect.gen(function* () {
+        const contentPath = path.join(subagentSrcPath, SUBAGENT_CONTENT_FILENAME);
+        const rawContent = yield* fs.readFileString(contentPath).pipe(Effect.mapError((error) => makeAppError({
+            code: "SUBAGENT_CONTENT_READ_FAILED",
+            what: `Failed to read ${SUBAGENT_CONTENT_FILENAME} from ${subagentSrcPath}`,
+            cause: error,
+        })));
+        const parsed = yield* parseSubagentMd(rawContent);
+        return { rawContent, parsed };
+    });
+    // Copy source to canonical location
+    const copyToCanonical = (sourcePath, targetPath) => Effect.gen(function* () {
+        yield* fs.makeDirectory(path.dirname(targetPath), { recursive: true }).pipe(Effect.mapError((error) => makeAppError({
+            code: "INSTALL_SUBAGENT_DIR_FAILED",
+            what: `Failed to create directory for subagent: ${targetPath}`,
+            cause: error,
+        })));
+        yield* provide(copyExtensionDirectory(sourcePath, targetPath).pipe(Effect.mapError((e) => makeAppError({
+            code: "INSTALL_SUBAGENT_COPY_FAILED",
+            what: `Failed to copy subagent files to ${targetPath}`,
+            cause: e,
+        }))));
+    });
+    // Materialize from registry
+    const materializeFromRegistry = (ref, canonicalPath) => Effect.gen(function* () {
+        const canonicalExists = yield* fs.exists(canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+            code: "INSTALL_SUBAGENT_PATH_CHECK_FAILED",
+            what: `Failed to check if canonical path exists: ${canonicalPath}`,
+            cause: e,
+        })));
+        const useExisting = Option.isNone(ref.integrity) && canonicalExists;
+        if (!useExisting) {
+            const locationStr = ref.source.location.protocol === "file:"
+                ? ref.source.location.pathname
+                : ref.source.location.href;
+            const client = yield* provide(createRegistryClient(locationStr));
+            const { archive } = yield* client.getExtensionPackage({
+                owner: ref.owner,
+                type: "subagent",
+                name: ref.name,
+                version: Option.some(ref.version),
+            });
+            if (Option.isSome(ref.integrity)) {
+                const actualIntegrity = yield* computeIntegrity(archive);
+                if (actualIntegrity !== ref.integrity.value) {
+                    return yield* makeAppError({
+                        code: "INSTALL_SUBAGENT_INTEGRITY_MISMATCH",
+                        what: `Integrity mismatch for ${ref.name}@${ref.version}`,
+                        details: [`Expected ${ref.integrity.value}, got ${actualIntegrity}`],
+                    });
+                }
+            }
+            const tmpDir = yield* fs.makeTempDirectory().pipe(Effect.mapError((e) => makeAppError({
+                code: "INSTALL_SUBAGENT_TEMP_DIR_FAILED",
+                what: `Failed to create temporary directory for registry install`,
+                cause: e,
+            })));
+            yield* Effect.ensuring(Effect.gen(function* () {
+                yield* provide(extractZip(archive, tmpDir));
+                yield* fs.remove(canonicalPath, { recursive: true }).pipe(Effect.ignore);
+                yield* provide(copyExtensionDirectory(tmpDir, canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+                    code: "INSTALL_SUBAGENT_COPY_FAILED",
+                    what: `Failed to copy subagent files to ${canonicalPath}`,
+                    cause: e,
+                }))));
+            }), fs.remove(tmpDir, { recursive: true }).pipe(Effect.ignore));
+        }
+    });
+    // Materialize canonical source for any ref type
+    const materializeCanonical = (ref, sanitized, canonicalPath, subagentSrcPath) => Effect.gen(function* () {
+        switch (ref.refType) {
+            case "git-hosted": {
+                const sourcePath = stripFileProtocol(ref.location);
+                yield* removeFromAllCanonicalLocations(fs, baseDir, sanitized, path);
+                yield* copyToCanonical(sourcePath, subagentSrcPath);
+                break;
+            }
+            case "local": {
+                const sourcePath = stripFileProtocol(ref.location);
+                const isSelfCopy = path.resolve(sourcePath) === path.resolve(subagentSrcPath);
+                if (!isSelfCopy) {
+                    yield* removeFromAllCanonicalLocations(fs, baseDir, sanitized, path);
+                    yield* copyToCanonical(sourcePath, subagentSrcPath);
+                }
+                break;
+            }
+            case "registry": {
+                yield* materializeFromRegistry(ref, canonicalPath);
+                break;
+            }
+        }
+    });
+    const materializeInstall = Effect.fn("SubagentManager.materializeInstall")(function* ({ ref }) {
+        const { sanitized, paths } = getCanonicalPaths(ref);
+        const { canonicalPath, subagentSrcPath } = paths;
+        // --- Materialize canonical source ---
+        yield* materializeCanonical(ref, sanitized, canonicalPath, subagentSrcPath);
+        // --- Read SUBAGENT.md ---
+        const { rawContent, parsed } = yield* readSubagentContent(subagentSrcPath);
+        const currentHash = computeSourceHash(rawContent);
+        // --- Source-hash-based skip logic (6.4) ---
+        const existingLockEntry = yield* ws.getLockedSubagent(ref.subagent.name);
+        if (Option.isSome(existingLockEntry)) {
+            const existing = existingLockEntry.value;
+            if (existing.sourceHash !== undefined && existing.sourceHash === currentHash) {
+                // Source unchanged, skip re-rendering
+                return;
+            }
+        }
+        // --- Resolve configured agents ---
+        const configuredAgents = yield* agentRepo
+            .getConfiguredAgents()
+            .pipe(Effect.provideService(Workspace, ws));
+        // --- Extract frontmatter fields ---
+        const frontmatter = Option.getOrUndefined(parsed.frontmatter);
+        // --- Render to all agents concurrently ---
+        const renderedFilesMap = {};
+        yield* Effect.forEach(configuredAgents, (agent) => agent
+            .addSubagent({
+            workspaceRoot: baseDir,
+            scope: "project",
+            input: {
+                agentId: agent.id,
+                name: ref.subagent.name,
+                description: frontmatter?.description ?? "",
+                model: frontmatter?.model,
+                toolAccess: frontmatter?.toolAccess,
+                background: frontmatter?.background,
+                body: parsed.body,
+                agentOverrides: frontmatter?.overrides,
+            },
+            force: false,
+        })
+            .pipe(Effect.provide(fsPathLayer), Effect.map((outcome) => {
+            if (outcome._tag === "success") {
+                renderedFilesMap[agent.id] = outcome.renderedFilePaths.map((p) => ({
+                    path: p,
+                }));
+            }
+        })), { concurrency: "unbounded" });
+        // --- Update lockfile with rendered files and source hash ---
+        const lockEntry = buildSubagentLockEntry(ref, agents, new Date());
+        const decodeRenderedFiles = Schema.decodeUnknownSync(RenderedFilesMapSchema);
+        const lockEntryWithRendered = {
+            ...lockEntry,
+            sourceHash: currentHash,
+            renderedFiles: decodeRenderedFiles(renderedFilesMap),
+        };
+        yield* ws.setSubagentLock({ name: ref.subagent.name, lockEntry: lockEntryWithRendered });
+    });
+    const materializeUninstall = Effect.fn("SubagentManager.materializeUninstall")(function* ({ target }) {
+        const sanitized = sanitizeName(target.name);
+        // --- Read rendered files from lockfile ---
+        const lockEntryOption = yield* ws.getLockedSubagent(target.name);
+        if (Option.isSome(lockEntryOption)) {
+            const lockEntry = lockEntryOption.value;
+            const renderedFiles = lockEntry.renderedFiles ?? {};
+            // --- Remove rendered files via CodingAgent.removeSubagent() ---
+            const configuredAgents = yield* agentRepo
+                .getConfiguredAgents()
+                .pipe(Effect.provideService(Workspace, ws));
+            yield* Effect.forEach(configuredAgents, (agent) => {
+                const agentFiles = renderedFiles[agent.id] ?? [];
+                return agent
+                    .removeSubagent({
+                    workspaceRoot: baseDir,
+                    scope: "project",
+                    subagentName: target.name,
+                    renderedFilePaths: agentFiles.map((f) => f.path),
+                })
+                    .pipe(Effect.provide(fsPathLayer));
+            }, { concurrency: "unbounded" });
+        }
+        // --- Remove canonical source directory ---
+        yield* removeFromAllCanonicalLocations(fs, baseDir, sanitized, path);
+    });
+    return {
+        type: "subagent",
+        isInstalled: Effect.fn("SubagentManager.isInstalled")(function* ({ target, }) {
+            const lockedSubagents = yield* ws.getLockedSubagents();
+            return target.name in lockedSubagents;
+        }),
+        materializeInstall,
+        materializeUninstall,
+        upsertSettingsEntry: ({ ref, }) => {
+            const lockEntry = buildSubagentLockEntry(ref, agents, new Date());
+            if (lockEntry.type === "registry") {
+                return validateExactResolvedVersion(`subagents.${ref.subagent.name}.resolvedVersion`, lockEntry.resolvedVersion).pipe(Effect.flatMap(() => ws.setSubagent({ name: ref.subagent.name, lockEntry })), Effect.withSpan("SubagentManager.upsertSettingsEntry"));
+            }
+            return ws
+                .setSubagent({ name: ref.subagent.name, lockEntry })
+                .pipe(Effect.withSpan("SubagentManager.upsertSettingsEntry"));
+        },
+        removeSettingsEntry: ({ target }) => ws
+            .removeSubagentSettings(target.name)
+            .pipe(Effect.withSpan("SubagentManager.removeSettingsEntry")),
+        upsertLockfileEntry: ({ ref }) => {
+            const lockEntry = buildSubagentLockEntry(ref, agents, new Date());
+            if (lockEntry.type === "registry") {
+                return validateExactResolvedVersion(`subagents.${ref.subagent.name}.resolvedVersion`, lockEntry.resolvedVersion).pipe(Effect.flatMap(() => ws.setSubagentLock({ name: ref.subagent.name, lockEntry })), Effect.withSpan("SubagentManager.upsertLockfileEntry"));
+            }
+            return ws
+                .setSubagentLock({ name: ref.subagent.name, lockEntry })
+                .pipe(Effect.withSpan("SubagentManager.upsertLockfileEntry"));
+        },
+        removeLockfileEntry: ({ target }) => ws
+            .removeSubagentLock(target.name)
+            .pipe(Effect.withSpan("SubagentManager.removeLockfileEntry")),
+    };
+}));
+//# sourceMappingURL=manager.js.map

package/dist/src/unstable/subagents/manager.js.map

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

package/dist/src/unstable/subagents/manifest-schema.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Subagent manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Filename for subagent manifest files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const MANIFEST_FILENAME = "subagent.json";
+/**
+ * URL for the subagent manifest JSON Schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/subagent.schema.json";
+/**
+ * Schema for subagent manifest files (subagent.json).
+ *
+ * Subagents are autonomous agent instances that can be delegated work
+ * by a parent agent, each with their own instructions, model preferences,
+ * and tool access controls.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SubagentManifestSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"subagent">;
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+    readonly model: Schema.optional<Schema.String>;
+    readonly toolAccess: Schema.optional<Schema.Literals<readonly ["full", "readonly", "none"]>>;
+    readonly background: Schema.optional<Schema.withConstructorDefault<Schema.Boolean>>;
+    readonly agents: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly version: Schema.brand<Schema.String, "ExactSemverVersion">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly keywords: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly repository: Schema.optional<Schema.String>;
+    readonly homepage: Schema.optional<Schema.String>;
+    readonly license: Schema.optional<Schema.String>;
+    readonly bugs: Schema.optional<Schema.String>;
+    readonly authors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly email: Schema.optional<Schema.String>;
+        readonly url: Schema.optional<Schema.String>;
+    }>>>;
+    readonly compatiblePackages: Schema.optional<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly type: Schema.brand<Schema.String, "PackageType">;
+        readonly namespace: Schema.optional<Schema.String>;
+        readonly name: Schema.String;
+        readonly version: Schema.optional<Schema.String>;
+    }>>, Schema.String, never, never>>>;
+    readonly $schema: Schema.optional<Schema.String>;
+}>;
+/**
+ * Inferred type for SubagentManifest schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentManifest = Schema.Schema.Type<typeof SubagentManifestSchema>;
+//# sourceMappingURL=manifest-schema.d.ts.map

package/dist/src/unstable/subagents/manifest-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/subagents/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,gDAAgD,CAAC;AAEjF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/src/unstable/subagents/manifest-schema.js

@@ -0,0 +1,45 @@
+/**
+ * Subagent manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { CommonManifestBaseFields, ExtensionNameSchema } from "../extensions/common.js";
+import { ToolAccessLevelSchema } from "./tool-access.js";
+/**
+ * Filename for subagent manifest files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const MANIFEST_FILENAME = "subagent.json";
+/**
+ * URL for the subagent manifest JSON Schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/subagent.schema.json";
+/**
+ * Schema for subagent manifest files (subagent.json).
+ *
+ * Subagents are autonomous agent instances that can be delegated work
+ * by a parent agent, each with their own instructions, model preferences,
+ * and tool access controls.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SubagentManifestSchema = Schema.Struct({
+    $schema: Schema.optional(Schema.String),
+    ...CommonManifestBaseFields,
+    type: Schema.Literal("subagent"),
+    name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "subagent name is required" })),
+    model: Schema.optional(Schema.String),
+    toolAccess: Schema.optional(ToolAccessLevelSchema),
+    background: Schema.optional(Schema.Boolean.pipe(Schema.withConstructorDefault(() => Option.some(false)))),
+    agents: Schema.optional(Schema.Array(Schema.String)),
+}).annotate({
+    identifier: "SubagentManifest",
+    title: "Subagent Manifest",
+    description: "Configuration file (subagent.json) that defines a subagent — an autonomous agent instance with its own instructions, model, and tool access.",
+});
+//# sourceMappingURL=manifest-schema.js.map

package/dist/src/unstable/subagents/manifest-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../../../src/unstable/subagents/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,6CAA6C,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,GAAG,wBAAwB;IAC3B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAC5B,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,CAAC,CACvE;IACD,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC,QAAQ,CACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAC7E;IACD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACrD,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,kBAAkB;IAC9B,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,8IAA8I;CACjJ,CAAC,CAAC"}

package/dist/src/unstable/subagents/operations/disable.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Disable subagent executor — removes rendered files but preserves canonical source.
+ *
+ * Three paths:
+ * - Lock entry present: full disable (remove rendered files + clear lock + settings)
+ * - No lock entry, configured: settings-only toggle
+ * - No lock entry, implicit: promote to configured entry with enabled: false
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { CodingAgentRepository } from "../../agents/index.js";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Disable a subagent (remove rendered files but keep settings/lockfile entry).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type DisableSubagentOperation = Operation<"disable-subagent", {
+    readonly subagentName: string;
+}>;
+/**
+ * Disable-subagent operation handler.
+ *
+ * Determines lifecycle via getInstalledSubagents, then branches:
+ *
+ * Implicit subagent -> promote to configured entry with enabled: false
+ *   - If lock entry exists: also remove rendered files
+ *   - If no lock entry: settings promotion only
+ *
+ * Configured subagent with lock entry -> full lock-backed disable
+ *   - Remove rendered files, update settings
+ *
+ * Configured subagent without lock entry -> settings-only toggle
+ *
+ * Canonical source files are preserved for later re-enablement.
+ */
+export declare const disableSubagent: OperationHandler<DisableSubagentOperation, FileSystem.FileSystem | Path.Path | Workspace | CodingAgentRepository>;
+//# sourceMappingURL=disable.d.ts.map

package/dist/src/unstable/subagents/operations/disable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/operations/disable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AA+BjE;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,kBAAkB,EAClB;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAClC,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,CAC5C,wBAAwB,EACxB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,qBAAqB,CAsEnE,CAAC"}