@agentxm/extension-lifecycle 0.29.4 → 0.30.2

package/dist/src/update/selective/subagents.js

@@ -15,10 +15,11 @@ import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import { decodeExtensionNameSync, parseSourceQualifiedRegistrySourcePatternParts, } from "@agentxm/extension-model/unstable/extensions";
 import { isWorkspaceSourceLocator } from "@agentxm/extension-model/unstable/sources/workspace";
-import { buildInstallOperation, SubagentManager } from "@agentxm/extension-materialization";
+import { SubagentManager } from "@agentxm/extension-materialization";
+import { buildInstallOperation } from "@agentxm/workspace-reconciliation";
 import { classifyPublisherBindingTransition, makeConfiguredReleaseAgeEvaluation, normalizeReleaseAgeRecords, publisherTransitionWarning, registryBindingProposal, } from "@agentxm/extension-resolution";
 import { resolveSource, SourceHostProviders } from "@agentxm/extension-sources";
-import { operationPresentation, prepareExecutionCandidate, StepFailure, } from "@agentxm/workspace-operations";
+import { operationPresentation, prepareExecutionCandidate, } from "@agentxm/workspace-operations";
 import { acceptedResolutionRef, configuredRowsByName, WorkspaceMutations, } from "@agentxm/workspace-state";
 import { ExtensionLifecycleFailed } from "../../errors.js";
 import { withPublisherTrustConditions } from "../../publisher-binding.js";
@@ -267,16 +268,17 @@ export const prepareSelectiveSubagentUpdate = Effect.fn("SelectiveSubagentUpdate
             warningsBySubagent.set(item.ref.subagent.name, publisherTransitionWarning(transition.value));
         }
     }
-    const makeRunClosure = (ref) => {
+    const makeStep = (ref) => {
         const step = buildInstallOperation(subagentManager, {
             toStepFailure: failureConversion.toStepFailure,
             ref,
-            versionRange: Option.none(),
         });
-        if (step.readiness === "error") {
-            return Effect.fail(new StepFailure({ category: "conflict", detail: step.errorMessage }));
-        }
-        return step.run.pipe(Effect.map(appendWarning(warningsBySubagent.get(ref.subagent.name))));
+        if (step.readiness === "error")
+            return step;
+        return {
+            ...step,
+            run: step.run.pipe(Effect.map(appendWarning(warningsBySubagent.get(ref.subagent.name)))),
+        };
     };
     const units = resolved.map((item) => ({
         name: item.ref.subagent.name,
@@ -284,7 +286,7 @@ export const prepareSelectiveSubagentUpdate = Effect.fn("SelectiveSubagentUpdate
         force: request.ignoreVersionConstraints,
         operation: item.ref,
     }));
-    const rawPlan = buildSelectiveUpdatePlan(units, lockedSubagents, PLAN_NAME, Option.some(PLAN_DESCRIPTION), makeRunClosure);
+    const rawPlan = buildSelectiveUpdatePlan(units, lockedSubagents, PLAN_NAME, Option.some(PLAN_DESCRIPTION), makeStep);
     const basePlanWithReleaseAge = {
         ...rawPlan,
         presentation: operationPresentation({ imperative: "update", past: "Updated", gerund: "Updating" }, "subagent"),

package/dist/src/update/selective/use-case.d.ts

@@ -36,7 +36,7 @@ export declare const prepareSelectiveUpdate: (request: SelectiveUpdateRequest) =
     outcome: "planned";
     subjectType: "skill";
     planName: string;
-    execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("./requirements.ts").SelectiveUpdateStepRequirements, never>;
+    execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("../../index.ts").InstallStepRequirements, never>;
     reason?: never;
     message?: never;
     planDescription?: never;
@@ -60,11 +60,11 @@ export declare const prepareSelectiveUpdate: (request: SelectiveUpdateRequest) =
     outcome: "planned";
     subjectType: "subagent";
     planName: string;
-    execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("./requirements.ts").SelectiveUpdateStepRequirements, never>;
+    execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("../../index.ts").InstallStepRequirements, never>;
     reason?: never;
     message?: never;
     planDescription?: never;
-}, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-state").WorkspaceMutations | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
+}, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-materialization").SkillManager | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog | import("../../index.ts").InstallStepRequirements>;
 /** Settle a selective update, then preview or apply it. */
 export declare const SelectiveUpdate: {
     readonly prepare: (request: SelectiveUpdateRequest) => Effect.Effect<{
@@ -87,7 +87,7 @@ export declare const SelectiveUpdate: {
         outcome: "planned";
         subjectType: "skill";
         planName: string;
-        execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("./requirements.ts").SelectiveUpdateStepRequirements, never>;
+        execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("../../index.ts").InstallStepRequirements, never>;
         reason?: never;
         message?: never;
         planDescription?: never;
@@ -111,11 +111,11 @@ export declare const SelectiveUpdate: {
         outcome: "planned";
         subjectType: "subagent";
         planName: string;
-        execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("./requirements.ts").SelectiveUpdateStepRequirements, never>;
+        execution: import("@agentxm/workspace-operations").ExecutionCandidate<import("../../index.ts").InstallStepRequirements, never>;
         reason?: never;
         message?: never;
         planDescription?: never;
-    }, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-state").WorkspaceMutations | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
-    readonly previewOrApply: (candidate: import("./vocabulary.js").PlannedSelectiveUpdateCandidate, execution: import("@agentxm/workspace-operations").PlanExecution) => Effect.Effect<import("@agentxm/workspace-operations").OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-transactions").WorkspaceTransitionAcquireFailure, import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/workspace-transactions").FootprintRecorder | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/workspace-operations").ResolvePlanInteraction | import("./requirements.ts").SelectiveUpdateStepRequirements>;
+    }, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-materialization").SkillManager | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog | import("../../index.ts").InstallStepRequirements>;
+    readonly previewOrApply: (candidate: import("./vocabulary.js").PlannedSelectiveUpdateCandidate, execution: import("@agentxm/workspace-operations").PlanExecution) => Effect.Effect<import("@agentxm/workspace-operations").OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-transactions").WorkspaceTransitionAcquireFailure, import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/workspace-transactions").FootprintRecorder | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/workspace-operations").ResolvePlanInteraction | import("../../index.ts").InstallStepRequirements>;
 };
 //# sourceMappingURL=use-case.d.ts.map

package/dist/src/update/selective/vocabulary.d.ts

@@ -39,5 +39,5 @@ export interface NothingSelectiveUpdateCandidate {
 }
 export type SelectiveUpdateCandidate = PlannedSelectiveUpdateCandidate | NothingSelectiveUpdateCandidate;
 /** Preview or apply a settled selective update. */
-export declare const previewOrApplySelectiveUpdate: (candidate: PlannedSelectiveUpdateCandidate, execution: PlanExecution) => import("effect/Effect").Effect<import("@agentxm/workspace-operations").OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-transactions").WorkspaceTransitionAcquireFailure, import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/workspace-transactions").FootprintRecorder | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/workspace-operations").ResolvePlanInteraction | SelectiveUpdateStepRequirements>;
+export declare const previewOrApplySelectiveUpdate: (candidate: PlannedSelectiveUpdateCandidate, execution: PlanExecution) => import("effect/Effect").Effect<import("@agentxm/workspace-operations").OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-transactions").WorkspaceTransitionAcquireFailure, import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/workspace-transactions").FootprintRecorder | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/workspace-operations").ResolvePlanInteraction | import("../../index.ts").InstallStepRequirements>;
 //# sourceMappingURL=vocabulary.d.ts.map

package/dist/src/update/selector.js

@@ -20,7 +20,7 @@ import { extensionTypeSentenceLabels, extensionTypePluralSentenceLabels, parseSo
 import { isCatalogExtensionType } from "@agentxm/extension-model/unstable/extension-types";
 import { SourceHostProviders, resolveInstalledIdentifierNameOrInput, resolveSource, } from "@agentxm/extension-sources";
 import { WorkspaceRecords, configuredRowsByName, enabledConfiguredEntries, } from "@agentxm/workspace-state";
-import { expandGlobs } from "../glob.js";
+import { expandGlobs } from "@agentxm/extension-model/unstable/extensions/name-patterns";
 /** The flag spelling reported when a `--name` filter matches nothing. */
 export const UPDATE_NAME_FILTER_FLAG = "--name";
 const sourceMatchesEntrySource = (sourceValue, entrySource) => Effect.gen(function* () {

package/dist/src/update/targeted-plan.js

@@ -1,3 +1,5 @@
+import { lifecycleStepFailure } from "../step-failure.js";
+import { buildReconciliationClosure, } from "@agentxm/workspace-reconciliation";
 /**
  * Wrapping a targeted update in one atomic ownership transition.
  *
@@ -18,7 +20,6 @@ import { operationPresentation, } from "@agentxm/workspace-operations";
 import { WorkspaceMutations } from "@agentxm/workspace-state";
 import { resolveTargetedUpdateContext, } from "@agentxm/extension-resolution";
 import { ExtensionLifecycleFailed } from "../errors.js";
-import { buildAtomicPackGraphStep } from "../packs/graph-transition.js";
 export const TARGETED_UPDATE_STALE_DETAIL = "The targeted update ownership context became stale before apply.";
 const same = (left, right) => JSON.stringify(left) === JSON.stringify(right);
 const validatePostcondition = (args) => {
@@ -63,7 +64,8 @@ export const wrapTargetedUpdatePlan = (args) => Effect.gen(function* () {
         scope: workspace.scope,
         change: "updated",
     };
-    const builtStep = yield* buildAtomicPackGraphStep({
+    const builtStep = yield* buildReconciliationClosure({
+        toStepFailure: lifecycleStepFailure,
         label: args.context.public.target.fqn,
         message: `Updated ${args.context.public.target.fqn}`,
         artifact,

package/dist/src/workspace-paths.d.ts

@@ -20,12 +20,6 @@ export declare const workspaceLockfilePath: (scope: WorkspaceScope) => string;
 export declare const workspaceCanonicalRoot: (scope: WorkspaceScope) => string;
 /** One acquired package's path, relative to the workspace root. */
 export declare const workspaceCanonicalPath: (scope: WorkspaceScope, relativePath: string) => string;
-/** Where one desired-graph node's package sits, authored or acquired. */
-export declare const workspaceCanonicalNodePath: (path: Path.Path, ws: WorkspaceMutationsService, node: {
-    readonly type: ExtensionType;
-    readonly name: string;
-    readonly identity: string;
-}) => string;
 /** Where a workspace-authored package of this type and name sits. */
 export declare const workspaceAuthoredPath: (path: Path.Path, ws: WorkspaceMutationsService, type: ExtensionType, name: string) => string;
 //# sourceMappingURL=workspace-paths.d.ts.map

package/dist/src/workspace-paths.js

@@ -25,16 +25,6 @@ const extensionDirectory = {
     knowledge: "knowledge",
     pack: "packs",
 };
-/** Where one desired-graph node's package sits, authored or acquired. */
-export const workspaceCanonicalNodePath = (path, ws, node) => {
-    if (node.identity.startsWith("workspace:") && ws.layout.scope === "project") {
-        return path.join(path.relative(ws.baseDir, ws.layout.authoredRoot(node.type)), node.name);
-    }
-    const identity = node.identity.startsWith("workspace:")
-        ? node.identity.slice("workspace:".length)
-        : node.identity;
-    return workspaceCanonicalPath(ws.scope, identity);
-};
 /** Where a workspace-authored package of this type and name sits. */
 export const workspaceAuthoredPath = (path, ws, type, name) => {
     if (ws.layout.scope === "project") {

package/package.json

@@ -4,20 +4,21 @@
     "url": "https://github.com/agentxm/axm/issues"
   },
   "dependencies": {
-    "@agentxm/agent-integration": "^0.29.4",
-    "@agentxm/extension-content": "^0.29.4",
-    "@agentxm/extension-materialization": "^0.29.4",
-    "@agentxm/extension-model": "^0.29.4",
-    "@agentxm/extension-resolution": "^0.29.4",
-    "@agentxm/extension-sources": "^0.29.4",
-    "@agentxm/registry-auth": "^0.29.4",
-    "@agentxm/registry-client": "^0.29.4",
-    "@agentxm/registry-protocol": "^0.29.4",
-    "@agentxm/workspace-operations": "^0.29.4",
-    "@agentxm/workspace-projection": "^0.29.4",
-    "@agentxm/workspace-state": "^0.29.4",
-    "@agentxm/workspace-transactions": "^0.29.4",
-    "@napi-rs/keyring": "^1.3.0",
+    "@agentxm/agent-integration": "^0.30.2",
+    "@agentxm/cli-maintenance": "^0.30.2",
+    "@agentxm/extension-content": "^0.30.2",
+    "@agentxm/extension-materialization": "^0.30.2",
+    "@agentxm/extension-model": "^0.30.2",
+    "@agentxm/extension-resolution": "^0.30.2",
+    "@agentxm/extension-sources": "^0.30.2",
+    "@agentxm/registry-auth": "^0.30.2",
+    "@agentxm/registry-client": "^0.30.2",
+    "@agentxm/registry-protocol": "^0.30.2",
+    "@agentxm/workspace-operations": "^0.30.2",
+    "@agentxm/workspace-projection": "^0.30.2",
+    "@agentxm/workspace-reconciliation": "^0.30.2",
+    "@agentxm/workspace-state": "^0.30.2",
+    "@agentxm/workspace-transactions": "^0.30.2",
     "effect": "4.0.0-rc.115",
     "fflate": "^0.8.3"
   },
@@ -37,19 +38,24 @@
   },
   "exports": {
     ".": {
-      "axm-source": "./src/index.ts",
-      "default": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
     },
     "./live": {
-      "axm-source": "./src/live.ts",
-      "default": "./dist/src/live.js",
-      "types": "./dist/src/live.d.ts"
+      "types": "./dist/src/live.d.ts",
+      "default": "./dist/src/live.js"
     },
     "./testing": {
-      "axm-source": "./src/testing.ts",
-      "default": "./dist/src/testing.js",
-      "types": "./dist/src/testing.d.ts"
+      "types": "./dist/src/testing.d.ts",
+      "default": "./dist/src/testing.js"
+    },
+    "./skills/application": {
+      "types": "./dist/src/skills/application/index.d.ts",
+      "default": "./dist/src/skills/application/index.js"
+    },
+    "./subagents/application": {
+      "types": "./dist/src/subagents/application/index.d.ts",
+      "default": "./dist/src/subagents/application/index.js"
     }
   },
   "files": [
@@ -72,5 +78,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.29.4"
+  "version": "0.30.2"
 }

package/dist/src/glob.d.ts

@@ -1,35 +0,0 @@
-/**
- * Glob expansion for extension names.
- *
- * Expands `*` wildcards against a list of names. Only `*` is supported
- * as a wildcard — all other characters are treated as literals.
- *
- * @experimental This API is unstable and may change without notice.
- */
-/**
- * Expand a glob pattern against a list of names.
- *
- * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
- * are treated as literals. Matching is case-sensitive.
- *
- * @param pattern - The pattern to match (may contain `*`)
- * @param names - Available names to match against
- * @returns Matching names in their original order
- */
-export declare const expandGlob: (pattern: string, names: ReadonlyArray<string>) => ReadonlyArray<string>;
-/**
- * Expand multiple glob patterns against a list of skill names.
- *
- * Returns the union of all matches, deduplicated, preserving the original
- * order of `names`.
- *
- * @param patterns - Patterns to match (may contain `*`)
- * @param names - Available names to match against
- * @returns Matching names in their original order, deduplicated
- */
-export declare const expandGlobs: (patterns: ReadonlyArray<string>, names: ReadonlyArray<string>) => ReadonlyArray<string>;
-/**
- * Returns true when an input should be treated as a glob pattern.
- */
-export declare const isGlobPattern: (input: string) => boolean;
-//# sourceMappingURL=glob.d.ts.map

package/dist/src/glob.js

@@ -1,75 +0,0 @@
-/**
- * Glob expansion for extension names.
- *
- * Expands `*` wildcards against a list of names. Only `*` is supported
- * as a wildcard — all other characters are treated as literals.
- *
- * @experimental This API is unstable and may change without notice.
- */
-/**
- * Expand a glob pattern against a list of names.
- *
- * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
- * are treated as literals. Matching is case-sensitive.
- *
- * @param pattern - The pattern to match (may contain `*`)
- * @param names - Available names to match against
- * @returns Matching names in their original order
- */
-export const expandGlob = (pattern, names) => {
-    const matches = (name) => {
-        let patternIndex = 0;
-        let nameIndex = 0;
-        let wildcardIndex = -1;
-        let wildcardNameIndex = 0;
-        while (nameIndex < name.length) {
-            const token = pattern[patternIndex];
-            if (token !== undefined && token !== "*" && token === name[nameIndex]) {
-                patternIndex += 1;
-                nameIndex += 1;
-            }
-            else if (token === "*") {
-                wildcardIndex = patternIndex;
-                wildcardNameIndex = nameIndex;
-                patternIndex += 1;
-            }
-            else if (wildcardIndex >= 0) {
-                patternIndex = wildcardIndex + 1;
-                wildcardNameIndex += 1;
-                nameIndex = wildcardNameIndex;
-            }
-            else {
-                return false;
-            }
-        }
-        while (pattern[patternIndex] === "*") {
-            patternIndex += 1;
-        }
-        return patternIndex === pattern.length;
-    };
-    return names.filter(matches);
-};
-/**
- * Expand multiple glob patterns against a list of skill names.
- *
- * Returns the union of all matches, deduplicated, preserving the original
- * order of `names`.
- *
- * @param patterns - Patterns to match (may contain `*`)
- * @param names - Available names to match against
- * @returns Matching names in their original order, deduplicated
- */
-export const expandGlobs = (patterns, names) => {
-    const matched = new Set();
-    for (const pattern of patterns) {
-        for (const name of expandGlob(pattern, names)) {
-            matched.add(name);
-        }
-    }
-    return names.filter((n) => matched.has(n));
-};
-/**
- * Returns true when an input should be treated as a glob pattern.
- */
-export const isGlobPattern = (input) => input.includes("*");
-//# sourceMappingURL=glob.js.map

package/dist/src/install/selection-interaction.d.ts

@@ -1,46 +0,0 @@
-/**
- * Choosing among the extensions a source offers.
- *
- * When a source contains several skills or subagents and the request named
- * none of them, someone has to choose. Which candidates are offered and what
- * a choice means is this feature's; how the choice is asked for — a terminal
- * multiselect, a test double, nothing at all — is the application's.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import type * as Array from "effect/Array";
-import * as ServiceMap from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type { SkillExtensionRef } from "@agentxm/extension-model/unstable/extensions/refs/skill";
-import type { SubagentExtensionRef } from "@agentxm/extension-model/unstable/extensions/refs/subagent";
-import type { ExtensionLifecycleFailed } from "../errors.js";
-declare const ExtensionSelectionCancelled_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "ExtensionSelectionCancelled";
-} & Readonly<A>;
-/**
- * The person was asked which extensions to install and declined to answer.
- * Nothing was written and nothing is pending, so the application reports a
- * cancelled invocation rather than a failure.
- */
-export declare class ExtensionSelectionCancelled extends ExtensionSelectionCancelled_base<{
-    readonly message: string;
-}> {
-}
-/**
- * A surface that cannot open the choice refuses with the feature's own typed
- * failure rather than reporting a cancellation nobody made: declining is a
- * clean exit, being unable to ask is a refusal the operator must act on. Both
- * callers already carry the pair, so naming it here narrows nothing.
- */
-export type ExtensionSelectionFailure = ExtensionSelectionCancelled | ExtensionLifecycleFailed;
-export interface ExtensionSelectionInteractionService {
-    /** Choose which of the discovered skills to install; at least one. */
-    readonly selectSkills: (candidates: Array.NonEmptyReadonlyArray<SkillExtensionRef>) => Effect.Effect<ReadonlyArray<SkillExtensionRef>, ExtensionSelectionFailure>;
-    /** Choose which of the discovered subagents to install; at least one. */
-    readonly selectSubagents: (candidates: Array.NonEmptyReadonlyArray<SubagentExtensionRef>) => Effect.Effect<ReadonlyArray<SubagentExtensionRef>, ExtensionSelectionFailure>;
-}
-declare const ExtensionSelectionInteraction_base: ServiceMap.ServiceClass<ExtensionSelectionInteraction, "@agentxm/extension-lifecycle/install/ExtensionSelectionInteraction", ExtensionSelectionInteractionService>;
-export declare class ExtensionSelectionInteraction extends ExtensionSelectionInteraction_base {
-}
-export {};
-//# sourceMappingURL=selection-interaction.d.ts.map

package/dist/src/install/selection-interaction.js

@@ -1,22 +0,0 @@
-/**
- * Choosing among the extensions a source offers.
- *
- * When a source contains several skills or subagents and the request named
- * none of them, someone has to choose. Which candidates are offered and what
- * a choice means is this feature's; how the choice is asked for — a terminal
- * multiselect, a test double, nothing at all — is the application's.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as ServiceMap from "effect/Context";
-import * as Data from "effect/Data";
-/**
- * The person was asked which extensions to install and declined to answer.
- * Nothing was written and nothing is pending, so the application reports a
- * cancelled invocation rather than a failure.
- */
-export class ExtensionSelectionCancelled extends Data.TaggedError("ExtensionSelectionCancelled") {
-}
-export class ExtensionSelectionInteraction extends ServiceMap.Service()("@agentxm/extension-lifecycle/install/ExtensionSelectionInteraction") {
-}
-//# sourceMappingURL=selection-interaction.js.map

package/dist/src/skills/install/selection.d.ts

@@ -1,26 +0,0 @@
-/**
- * Which of a source's skills this request installs.
- *
- * Named skills are matched by glob and every named pattern must match
- * something; `--all` and an unattended invocation take everything; a source
- * offering exactly one skill needs no decision; anything else is a choice
- * only a person can make.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Array from "effect/Array";
-import * as Effect from "effect/Effect";
-import type { SkillExtensionRef } from "@agentxm/extension-model/unstable/extensions/refs/skill";
-import type { ExtensionLifecycleFailed } from "../../errors.js";
-import { ExtensionSelectionInteraction, type ExtensionSelectionCancelled } from "../../install/selection-interaction.js";
-export interface SkillSelectionRequest {
-    /** Names or glob patterns the request named explicitly. */
-    readonly requestedSkills: ReadonlyArray<string>;
-    /** Take everything the source offers without asking. */
-    readonly all: boolean;
-    /** No prompt can open in this invocation. */
-    readonly nonInteractive: boolean;
-}
-/** Settle which discovered skills this request installs. */
-export declare const determineSkillsToInstall: (skills: Array.NonEmptyReadonlyArray<SkillExtensionRef>, request: SkillSelectionRequest) => Effect.Effect<ReadonlyArray<SkillExtensionRef>, ExtensionLifecycleFailed | ExtensionSelectionCancelled, ExtensionSelectionInteraction>;
-//# sourceMappingURL=selection.d.ts.map

package/dist/src/skills/install/selection.js

@@ -1,41 +0,0 @@
-/**
- * Which of a source's skills this request installs.
- *
- * Named skills are matched by glob and every named pattern must match
- * something; `--all` and an unattended invocation take everything; a source
- * offering exactly one skill needs no decision; anything else is a choice
- * only a person can make.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Array from "effect/Array";
-import * as Effect from "effect/Effect";
-import { expandGlobs } from "../../glob.js";
-import { ExtensionSelectionInteraction, } from "../../install/selection-interaction.js";
-import { installRefused } from "../../install/vocabulary.js";
-/** Settle which discovered skills this request installs. */
-export const determineSkillsToInstall = Effect.fn("InstallExtensions.determineSkillsToInstall")(function* (skills, request) {
-    if (request.requestedSkills.length > 0) {
-        const allNames = Array.map(skills, (skill) => skill.skill.name);
-        const matched = expandGlobs(request.requestedSkills, allNames);
-        if (matched.length === 0) {
-            return yield* installRefused({
-                category: "not_found",
-                detail: `No skills matched: ${request.requestedSkills.join(", ")}. Source contains: ${[
-                    ...allNames,
-                ]
-                    .sort((left, right) => left.localeCompare(right))
-                    .join(", ")}`,
-                recover: "Check the skill names or patterns and try again",
-            });
-        }
-        return Array.filter(skills, (skill) => matched.includes(skill.skill.name));
-    }
-    if (request.all || request.nonInteractive)
-        return skills;
-    if (skills.length === 1)
-        return skills;
-    const interaction = yield* ExtensionSelectionInteraction;
-    return yield* interaction.selectSkills(skills);
-});
-//# sourceMappingURL=selection.js.map

package/dist/src/skills/operations/install-result.d.ts

@@ -1,33 +0,0 @@
-/**
- * Structured per-agent installation result.
- *
- * Captures the outcome of installing a skill for a single agent,
- * including success/failure state and symlink fallback information.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import type * as Option from "effect/Option";
-/**
- * Result of installing a skill for a single agent.
- *
- * - `success: true, mode: "symlink"` — installed via symlink
- * - `success: true, mode: "copy"` — symlink failed, fell back to copy
- * - `success: false` — installation failed
- */
-export interface InstallResult {
-    /** Whether the installation succeeded for this agent. */
-    readonly success: boolean;
-    /** Installation mode used ("symlink" or "copy"). */
-    readonly mode: "symlink" | "copy";
-    /** Whether symlink creation was attempted and failed (triggering copy fallback). */
-    readonly symlinkFailed: boolean;
-    /** Error message if installation failed. */
-    readonly error: Option.Option<string>;
-    /** Agent-specific skill directory path. */
-    readonly path: string;
-    /** Exact source-qualified canonical skill location. */
-    readonly canonicalPath: string;
-    /** User-visible change at the agent-specific skill path. */
-    readonly change?: "created" | "updated" | "unchanged";
-}
-//# sourceMappingURL=install-result.d.ts.map

package/dist/src/skills/operations/install-result.js

@@ -1,10 +0,0 @@
-/**
- * Structured per-agent installation result.
- *
- * Captures the outcome of installing a skill for a single agent,
- * including success/failure state and symlink fallback information.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export {};
-//# sourceMappingURL=install-result.js.map

package/dist/src/skills/operations/install.d.ts

@@ -1,67 +0,0 @@
-/**
- * Install skill executor — orchestrates the full per-skill installation pipeline.
- *
- * Dispatches to a per-refType install function via `switch(ref.refType)`, then
- * runs shared post-install steps (agent symlinks, lockfile/settings writes).
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as FileSystem from "effect/FileSystem";
-import type * as HttpClient from "effect/unstable/http/HttpClient";
-import * as Path from "effect/Path";
-import * as Option from "effect/Option";
-import type { AgentId } from "@agentxm/extension-model/unstable/agents/types";
-import { type RenderedFilesMap } from "@agentxm/workspace-state";
-import type { SkillExtensionRef } from "@agentxm/extension-model/unstable/extensions/refs/skill";
-import { SourceHostProviders } from "@agentxm/extension-sources";
-import { CodingAgentRepository } from "@agentxm/workspace-projection";
-import { StepFailureConversion } from "../../step-failure-conversion.js";
-import type { OperationHandler } from "@agentxm/workspace-operations";
-import type { Operation } from "@agentxm/workspace-operations";
-import type { JobStepArtifactSource } from "@agentxm/workspace-operations";
-import { WorkspaceMutations } from "@agentxm/workspace-state";
-import type { InstallResult } from "./install-result.js";
-/**
- * Args for the install-skill operation.
- */
-export type InstallSkillOperationArgs = {
-    readonly ref: SkillExtensionRef;
-    readonly force: boolean;
-    /** Version constraint from the original input when available. */
-    readonly versionRange: Option.Option<string>;
-    /** When true, write to lockfile only (skip settings). Used for pack dependencies. */
-    readonly skipSettings: Option.Option<boolean>;
-    /** When true, fail on unknown configured agents instead of warning+skip. */
-    readonly strictUnknownAgents: Option.Option<boolean>;
-    /** Named registry source that provided the ref (written to lockfile for registry skills). */
-    readonly sourceName: Option.Option<string>;
-};
-/**
- * Add a skill to the workspace.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export type InstallSkillOperation = Operation<"install-skill", InstallSkillOperationArgs>;
-export declare const gitHostedSkillArtifactSource: (ref: SkillExtensionRef) => JobStepArtifactSource | undefined;
-export { computeSkillSourceHash } from "@agentxm/extension-materialization";
-/**
- * Build a RenderedFilesMap from per-agent copy-mode install results.
- * Only includes agents where mode === "copy" and success === true.
- *
- * @internal Exported for testing only.
- */
-export declare const buildRenderedFilesFromResults: (installableTargets: ReadonlyArray<{
-    agentId: AgentId;
-    targetDir: string;
-}>, agentResults: ReadonlyArray<InstallResult>, toWorkspaceRelativePath: (path: string) => string) => RenderedFilesMap;
-/**
- * Install-skill operation handler.
- *
- * Dispatches to a per-refType install function producing a MaterializedSkill,
- * then runs shared post-install steps:
- * 1. Create symlinks from each agent's skills dir (concurrent)
- * 2. Update lockfile/settings entry (failures logged as warnings)
- * 3. Compute and return overall result
- */
-export declare const installSkill: OperationHandler<InstallSkillOperation, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path | WorkspaceMutations | SourceHostProviders | CodingAgentRepository | StepFailureConversion>;
-//# sourceMappingURL=install.d.ts.map