@agentxm/client-core 0.1.6

package/dist/src/unstable/subagents/operations/disable.js

@@ -0,0 +1,114 @@
+/**
+ * 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 * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+/** Derive a source string from lock entry metadata for implicit subagent promotion. */
+const deriveSourceString = (lockEntry) => {
+    switch (lockEntry.type) {
+        case "local":
+            return lockEntry.path;
+        case "registry":
+            return `${lockEntry.owner}/subagents/${lockEntry.name}`;
+        case "github":
+            return `${lockEntry.owner}/${lockEntry.repo}`;
+        case "gitlab":
+            return `${lockEntry.owner}/${lockEntry.repo}`;
+        case "bitbucket":
+            return `${lockEntry.owner}/${lockEntry.repo}`;
+        case "azurerepos":
+            return `${lockEntry.organization}/${lockEntry.project}/${lockEntry.repo}`;
+        case "git":
+            return lockEntry.url;
+    }
+};
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * 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 const disableSubagent = (op) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const agentRepo = yield* CodingAgentRepository;
+    // Read lifecycle to determine promotion needs
+    const installedSubagents = yield* ws.getInstalledSubagents();
+    const installed = installedSubagents[op.args.subagentName];
+    const isImplicit = installed !== undefined && installed.lifecycle === "implicit";
+    // Check for lock entry
+    const lockEntryOption = yield* ws.getLockedSubagent(op.args.subagentName).pipe(Effect.mapError((e) => makeAppError({
+        code: "DISABLE_SUBAGENT_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    const hasLockEntry = Option.isSome(lockEntryOption);
+    // Lock-backed file operations (when lock entry exists)
+    if (hasLockEntry) {
+        const lockEntry = lockEntryOption.value;
+        const renderedFiles = lockEntry.renderedFiles ?? {};
+        // Remove rendered files via CodingAgent.removeSubagent()
+        const configuredAgents = yield* agentRepo.getConfiguredAgents();
+        yield* Effect.forEach(configuredAgents, (agent) => {
+            const agentFiles = renderedFiles[agent.id] ?? [];
+            return agent.removeSubagent({
+                workspaceRoot: ws.baseDir,
+                scope: "project",
+                subagentName: op.args.subagentName,
+                renderedFilePaths: agentFiles.map((f) => f.path),
+            });
+        }, { concurrency: "unbounded" });
+    }
+    // State mutation: implicit promotion or configured toggle
+    if (isImplicit) {
+        // Implicit promotion: derive source via deterministic fallback order
+        // 1. lock entry metadata  2. fail
+        const source = hasLockEntry ? deriveSourceString(lockEntryOption.value) : undefined;
+        if (source === undefined) {
+            return yield* makeAppError({
+                code: "DISABLE_SUBAGENT_NO_SOURCE",
+                what: `Cannot determine source for implicit subagent "${op.args.subagentName}"`,
+                howToFix: "Provide a source when disabling this subagent",
+            });
+        }
+        yield* ws.setSubagentEntry(op.args.subagentName, { source, enabled: false });
+    }
+    else {
+        // Configured subagent — toggle enabled flag
+        yield* ws
+            .updateSubagentEntry(op.args.subagentName, (e) => ({ ...e, enabled: false }))
+            .pipe(Effect.catch(() => Effect.void));
+    }
+    return {
+        result: "success",
+        message: `Disabled ${op.args.subagentName}`,
+    };
+});
+//# sourceMappingURL=disable.js.map

package/dist/src/unstable/subagents/operations/disable.js.map

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

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

@@ -0,0 +1,40 @@
+/**
+ * Enable subagent executor — re-renders agent-native files for a previously disabled subagent.
+ *
+ * Two paths:
+ * - Lock entry present: full enable (render files + update lock + settings)
+ * - No lock entry: settings-only toggle (configured subagent with no lock backing)
+ *
+ * @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";
+/**
+ * Enable a previously disabled subagent (re-render files and update state).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type EnableSubagentOperation = Operation<"enable-subagent", {
+    readonly subagentName: string;
+}>;
+/**
+ * Enable-subagent operation handler.
+ *
+ * Lock-backed path:
+ * 1. Read configured agents, lock entry
+ * 2. Compute canonical path
+ * 3. Verify canonical directory exists
+ * 4. Read and parse SUBAGENT.md
+ * 5. Render to all agents (concurrent)
+ * 6. Update lockfile with rendered files and source hash
+ * 7. Update settings entry to set enabled: true
+ *
+ * Settings-only path (no lock entry):
+ * 1. Update settings entry to set enabled: true
+ */
+export declare const enableSubagent: OperationHandler<EnableSubagentOperation, FileSystem.FileSystem | Path.Path | Workspace | CodingAgentRepository>;
+//# sourceMappingURL=enable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/operations/enable.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAIpC,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;AAYjE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAC7C,iBAAiB,EACjB;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAClC,CAAC;AAkBF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAC3C,uBAAuB,EACvB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,qBAAqB,CA+GnE,CAAC"}

package/dist/src/unstable/subagents/operations/enable.js

@@ -0,0 +1,136 @@
+/**
+ * Enable subagent executor — re-renders agent-native files for a previously disabled subagent.
+ *
+ * Two paths:
+ * - Lock entry present: full enable (render files + update lock + settings)
+ * - No lock entry: settings-only toggle (configured subagent with no lock backing)
+ *
+ * @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 Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { sanitizeName } from "../../extensions/utils.js";
+import { computeSourceHash, RenderedFilesMapSchema } from "../../extensions/rendered-files.js";
+import { computeSubagentPaths, SUBAGENT_CONTENT_FILENAME } from "../paths.js";
+import { parseSubagentMd } from "../subagent-content.js";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+/** Derive a SubagentPathSource from a lock entry type. */
+const lockEntryToPathSource = (lockEntry) => lockEntry.type === "registry"
+    ? { refType: "registry", owner: lockEntry.owner }
+    : lockEntry.type === "local"
+        ? { refType: "local" }
+        : { refType: "git-hosted" };
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Enable-subagent operation handler.
+ *
+ * Lock-backed path:
+ * 1. Read configured agents, lock entry
+ * 2. Compute canonical path
+ * 3. Verify canonical directory exists
+ * 4. Read and parse SUBAGENT.md
+ * 5. Render to all agents (concurrent)
+ * 6. Update lockfile with rendered files and source hash
+ * 7. Update settings entry to set enabled: true
+ *
+ * Settings-only path (no lock entry):
+ * 1. Update settings entry to set enabled: true
+ */
+export const enableSubagent = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const agentRepo = yield* CodingAgentRepository;
+    // Check for lock entry to determine path
+    const lockEntryOption = yield* ws.getLockedSubagent(op.args.subagentName);
+    // Settings-only path: no lock entry, just toggle enabled flag
+    if (Option.isNone(lockEntryOption)) {
+        yield* ws
+            .updateSubagentEntry(op.args.subagentName, (e) => ({ ...e, enabled: true }))
+            .pipe(Effect.catch(() => Effect.void));
+        return {
+            result: "success",
+            message: `Enabled ${op.args.subagentName}`,
+        };
+    }
+    // Lock-backed path: full enable with rendering
+    const lockEntry = lockEntryOption.value;
+    const baseDir = ws.baseDir;
+    const pathSource = lockEntryToPathSource(lockEntry);
+    const sanitized = sanitizeName(op.args.subagentName);
+    const paths = computeSubagentPaths(path.join, baseDir, pathSource, sanitized);
+    // Verify canonical source exists
+    const exists = yield* fs
+        .exists(paths.subagentSrcPath)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!exists) {
+        return yield* makeAppError({
+            code: "ENABLE_SUBAGENT_MISSING_FILES",
+            what: `Subagent files for "${op.args.subagentName}" not found at ${paths.subagentSrcPath}`,
+            howToFix: "Try reinstalling the subagent with `axm subagents install`",
+        });
+    }
+    // Read and parse SUBAGENT.md
+    const contentPath = path.join(paths.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 ${paths.subagentSrcPath}`,
+        cause: error,
+    })));
+    const parsed = yield* parseSubagentMd(rawContent);
+    const currentHash = computeSourceHash(rawContent);
+    const frontmatter = Option.getOrUndefined(parsed.frontmatter);
+    // Render to all configured agents
+    const configuredAgents = yield* agentRepo.getConfiguredAgents();
+    const renderedFilesMap = {};
+    yield* Effect.forEach(configuredAgents, (agent) => agent
+        .addSubagent({
+        workspaceRoot: baseDir,
+        scope: "project",
+        input: {
+            agentId: agent.id,
+            name: op.args.subagentName,
+            description: frontmatter?.description ?? "",
+            model: frontmatter?.model,
+            toolAccess: frontmatter?.toolAccess,
+            background: frontmatter?.background,
+            body: parsed.body,
+            agentOverrides: frontmatter?.overrides,
+        },
+        force: false,
+    })
+        .pipe(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 decodeRenderedFiles = Schema.decodeUnknownSync(RenderedFilesMapSchema);
+    const updatedLockEntry = {
+        ...lockEntry,
+        sourceHash: currentHash,
+        renderedFiles: decodeRenderedFiles(renderedFilesMap),
+    };
+    yield* ws.setSubagentLock({ name: op.args.subagentName, lockEntry: updatedLockEntry });
+    // Update settings entry to set enabled: true
+    yield* ws
+        .updateSubagentEntry(op.args.subagentName, (e) => ({ ...e, enabled: true }))
+        .pipe(Effect.catch(() => Effect.void));
+    return {
+        result: "success",
+        message: `Enabled ${op.args.subagentName}`,
+    };
+});
+//# sourceMappingURL=enable.js.map

package/dist/src/unstable/subagents/operations/enable.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * Publish subagent executor -- reads a managed subagent's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the publish-subagent operation.
+ *
+ * Reads the manifest from `.axm/extensions/`, builds a zip archive,
+ * computes the SRI integrity hash, and publishes to the target registry.
+ */
+export type PublishSubagentOperationArgs = {
+    /** Extension identity in `@owner/subagents/name` format. */
+    readonly name: string;
+    /** Named source to publish to (e.g. "local"). */
+    readonly registryName: string;
+};
+/**
+ * Publish a managed subagent to a registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PublishSubagentOperation = Operation<"publish-subagent", PublishSubagentOperationArgs>;
+/**
+ * Publish-subagent operation handler.
+ *
+ * 1. Read and validate `subagent.json` manifest
+ * 2. Sync frontmatter fields from SUBAGENT.md to manifest
+ * 3. Build zip archive of extension directory
+ * 4. Compute SRI integrity hash
+ * 5. Resolve target registry provider by source name
+ * 6. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export declare const publishSubagent: OperationHandler<PublishSubagentOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/operations/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAcpC,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;AAOjE;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,CAAC;AAMnG;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,CAC5C,wBAAwB,EACxB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA+K3C,CAAC"}

package/dist/src/unstable/subagents/operations/publish.js

@@ -0,0 +1,164 @@
+/**
+ * Publish subagent executor -- reads a managed subagent's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @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 Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { REGISTRY_EXTENSIONS_DIR, parseFqn } from "../../extensions/index.js";
+import { SubagentManifestSchema, MANIFEST_FILENAME, } from "../manifest-schema.js";
+import { createRegistryClient } from "../../registry/index.js";
+import { buildZipArchive, computeIntegrity } from "../../utils/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { parseSubagentMd, projectFrontmatterToManifest } from "../subagent-content.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Publish-subagent operation handler.
+ *
+ * 1. Read and validate `subagent.json` manifest
+ * 2. Sync frontmatter fields from SUBAGENT.md to manifest
+ * 3. Build zip archive of extension directory
+ * 4. Compute SRI integrity hash
+ * 5. Resolve target registry provider by source name
+ * 6. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export const publishSubagent = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const fqn = yield* parseFqn(op.args.name);
+    // Locate the managed extension directory
+    const extensionDir = path.join(base, REGISTRY_EXTENSIONS_DIR, fqn.owner, "subagents", fqn.name);
+    const extensionDirExists = yield* fs
+        .exists(extensionDir)
+        .pipe(Effect.orElseSucceed(() => false));
+    if (!extensionDirExists) {
+        return yield* makeAppError({
+            code: "PUBLISH_SUBAGENT_NOT_FOUND",
+            what: `Managed subagent not found: ${extensionDir}`,
+        });
+    }
+    // Read and validate manifest
+    const manifestPath = path.join(extensionDir, MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SUBAGENT_MANIFEST_READ_FAILED",
+        what: `Failed to read manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    const manifestJson = yield* Effect.try({
+        try: () => {
+            const parsed = JSON.parse(manifestContent);
+            return parsed;
+        },
+        catch: (e) => makeAppError({
+            code: "PUBLISH_SUBAGENT_MANIFEST_PARSE_FAILED",
+            what: `Invalid JSON in manifest: ${manifestPath}`,
+            cause: e,
+        }),
+    });
+    let manifest = yield* Schema.decodeUnknownEffect(SubagentManifestSchema)(manifestJson).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SUBAGENT_MANIFEST_SCHEMA_INVALID",
+        what: `Invalid manifest schema: ${manifestPath}`,
+        cause: e,
+    })));
+    // Sync frontmatter fields from SUBAGENT.md to manifest
+    const contentPath = path.join(extensionDir, "src", "SUBAGENT.md");
+    const contentExists = yield* fs.exists(contentPath).pipe(Effect.orElseSucceed(() => false));
+    if (contentExists) {
+        const rawContent = yield* fs.readFileString(contentPath).pipe(Effect.mapError((e) => makeAppError({
+            code: "PUBLISH_SUBAGENT_CONTENT_READ_FAILED",
+            what: `Failed to read SUBAGENT.md: ${contentPath}`,
+            cause: e,
+        })));
+        const parsed = yield* parseSubagentMd(rawContent);
+        if (Option.isSome(parsed.frontmatter)) {
+            const projected = projectFrontmatterToManifest(parsed.frontmatter.value);
+            manifest = {
+                ...manifest,
+                ...(projected.description !== undefined && { description: projected.description }),
+                ...(projected.model !== undefined && { model: projected.model }),
+                ...(projected.toolAccess !== undefined && { toolAccess: projected.toolAccess }),
+                ...(projected.background !== undefined && { background: projected.background }),
+            };
+            // Write synced manifest back to disk
+            yield* fs.writeFileString(manifestPath, JSON.stringify(manifest, null, 2) + "\n").pipe(Effect.mapError((e) => makeAppError({
+                code: "PUBLISH_SUBAGENT_MANIFEST_WRITE_FAILED",
+                what: `Failed to write synced manifest: ${manifestPath}`,
+                cause: e,
+            })));
+        }
+    }
+    // Build zip archive from extension directory (includes manifest + src/)
+    const archive = yield* buildZipArchive(extensionDir, "PUBLISH_SUBAGENT_ARCHIVE_FAILED");
+    // Compute integrity
+    const integrity = yield* computeIntegrity(archive);
+    // Resolve target registry source
+    const registrySource = yield* ws.getConfiguredSourceByName(op.args.registryName).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SUBAGENT_REGISTRY_LOOKUP_FAILED",
+        what: `Failed to lookup registry source "${op.args.registryName}"`,
+        cause: e,
+    })));
+    if (Option.isNone(registrySource)) {
+        return yield* makeAppError({
+            code: "PUBLISH_SUBAGENT_REGISTRY_NOT_FOUND",
+            what: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const source = registrySource.value;
+    if (source.type !== "registry") {
+        return yield* makeAppError({
+            code: "PUBLISH_SUBAGENT_REGISTRY_NOT_FOUND",
+            what: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const registryUrl = source.location.href;
+    const client = yield* createRegistryClient(registryUrl);
+    // Build version entry metadata
+    const versionEntry = {
+        version: manifest.version,
+        published: new Date().toISOString(),
+        integrity,
+        ...(manifest.compatiblePackages !== undefined && {
+            compatiblePackages: manifest.compatiblePackages,
+        }),
+    };
+    // Publish to registry (idempotent)
+    yield* client
+        .publishExtension({
+        owner: fqn.owner,
+        type: "subagent",
+        name: fqn.name,
+        version: manifest.version,
+        archive,
+        metadata: versionEntry,
+    })
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SUBAGENT_PUBLISH_FAILED",
+        what: `Failed to publish to registry "${op.args.registryName}"`,
+        details: [
+            `Registry source: ${op.args.registryName}`,
+            `Registry URL: ${registryUrl}`,
+            `Extension: ${op.args.name}@${manifest.version}`,
+            `Registry error: ${e.what} (${e.code})`,
+            ...e.details,
+        ],
+        ...(Option.isSome(e.howToFix) && { howToFix: e.howToFix.value }),
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Published ${op.args.name}@${manifest.version}`,
+    };
+});
+//# sourceMappingURL=publish.js.map

package/dist/src/unstable/subagents/operations/publish.js.map

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

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

@@ -0,0 +1,57 @@
+/**
+ * Centralized subagent path computation.
+ *
+ * Provides types and a pure function for computing subagent directory paths
+ * based on source type (registry vs non-registry).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { Handle } from "../extensions/handle.js";
+/**
+ * Minimal structural discriminant for determining subagent path layout.
+ *
+ * Registry refs carry an owner for the canonical path; all other ref types
+ * use the shared external extensions directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentPathSource = {
+    readonly refType: "registry";
+    readonly owner: Handle;
+} | {
+    readonly refType: "git-hosted" | "local";
+};
+/**
+ * Computed paths for an installed subagent directory.
+ *
+ * - `canonicalPath`: root of the installed subagent
+ * - `subagentSrcPath`: where actual subagent source files live
+ *
+ * Non-registry: `canonicalPath === subagentSrcPath` = `<base>/.axm/extensions/external/subagents/<sanitized-name>`
+ * Registry: `canonicalPath` = `<base>/.axm/extensions/<owner>/subagents/<sanitized-name>`,
+ *           `subagentSrcPath` = `<canonicalPath>/src`
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SubagentDirPaths {
+    readonly canonicalPath: string;
+    readonly subagentSrcPath: string;
+}
+/**
+ * Content filename for subagent instructions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SUBAGENT_CONTENT_FILENAME = "SUBAGENT.md";
+/**
+ * Pure function to compute subagent directory paths.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param source - Source type discriminant
+ * @param sanitizedName - Sanitized subagent name for filesystem use
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const computeSubagentPaths: (join: (...paths: string[]) => string, base: string, source: SubagentPathSource, sanitizedName: string) => SubagentDirPaths;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/unstable/subagents/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAA;CAAE,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EACpC,MAAM,MAAM,EACZ,QAAQ,kBAAkB,EAC1B,eAAe,MAAM,KACpB,gBAaF,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Centralized subagent path computation.
+ *
+ * Provides types and a pure function for computing subagent directory paths
+ * based on source type (registry vs non-registry).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "../extensions/index.js";
+/**
+ * Content filename for subagent instructions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SUBAGENT_CONTENT_FILENAME = "SUBAGENT.md";
+/**
+ * Pure function to compute subagent directory paths.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param source - Source type discriminant
+ * @param sanitizedName - Sanitized subagent name for filesystem use
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const computeSubagentPaths = (join, base, source, sanitizedName) => {
+    if (source.refType === "registry") {
+        const canonicalPath = join(base, REGISTRY_EXTENSIONS_DIR, source.owner, "subagents", sanitizedName);
+        return { canonicalPath, subagentSrcPath: join(canonicalPath, "src") };
+    }
+    const canonicalPath = join(base, EXTERNAL_EXTENSIONS_DIR, "subagents", sanitizedName);
+    return { canonicalPath, subagentSrcPath: canonicalPath };
+};
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/unstable/subagents/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAgC1F;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAoC,EACpC,IAAY,EACZ,MAA0B,EAC1B,aAAqB,EACH,EAAE;IACpB,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,IAAI,CACxB,IAAI,EACJ,uBAAuB,EACvB,MAAM,CAAC,KAAK,EACZ,WAAW,EACX,aAAa,CACd,CAAC;QACF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IACtF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;AAC3D,CAAC,CAAC"}