@skaile/workspaces 1.3.0 → 1.4.0

package/dist/cli/src/commands/preset-apply.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `skaile preset apply` — pure core: reverse a `.preset.yaml` snapshot back into
+ * a workspace's `skaile.yaml` sections (the inverse of `preset export`).
+ *
+ * These helpers are I/O- and prompt-free so they can be unit-tested in
+ * isolation. The Commander action in `preset-cmd.ts` owns file reads, the
+ * interactive prompting for non-secret inputs, the editor writes, and the
+ * post-apply install.
+ */
+import type { ConnectorDeclaration, McpServerDeclaration, SourceEntry } from "@skaile/workspaces/core";
+import type { Placeholder, PresetManifest } from "@skaile/workspaces/types/manifests";
+/** The workspace sections produced by reversing a preset's items. */
+export interface WorkspaceItems {
+    /** Bare dependency refs, copied verbatim from non-connector/mcp items. */
+    dependencies: string[];
+    /** Connector declarations rebuilt from `connector:<driver>` items. */
+    connectors: ConnectorDeclaration[];
+    /** MCP server declarations rebuilt from `mcp:<id>` items. */
+    mcpServers: McpServerDeclaration[];
+    /** Git sources the deps resolve from — registered before install. */
+    sources: SourceEntry[];
+    /** Secret placeholder keys the user must export as env vars before running. */
+    envVarsToSet: string[];
+}
+/** Rejection message for nested preset refs (unsupported by v1 apply). */
+export declare const NESTED_PRESET_UNSUPPORTED = "nested presets are not supported by `preset apply` yet";
+/**
+ * Resolve one placeholder to the value that lands in `skaile.yaml`.
+ *
+ * A secret placeholder NEVER yields its raw value — it resolves to an
+ * `env:<KEY>` indirection reference so the credential stays out of the file.
+ * A non-secret placeholder resolves to the provided literal (or its declared
+ * default); a required non-secret placeholder with neither throws.
+ *
+ * @param placeholder - The placeholder definition from the preset item.
+ * @param providedValue - Value supplied via `--input`/prompt, or `undefined`.
+ * @returns `{ envRef }` for secrets, `{ value }` for resolved literals.
+ * @throws When a required non-secret placeholder has no value and no default.
+ */
+export declare function resolvePlaceholderValue(placeholder: Placeholder, providedValue: string | undefined): {
+    value: string;
+} | {
+    envRef: string;
+};
+/**
+ * Reverse a preset's items into additive `skaile.yaml` sections.
+ *
+ * Items are classified by **`id` presence** (export writes one on connector/mcp
+ * items, never on deps), so a bare `mcp:excel` shorthand stays a dependency.
+ * Secret tokens resolve to `env:<KEY>` refs (collected into `envVarsToSet`).
+ *
+ * @param preset - The validated preset manifest.
+ * @param values - Resolved non-secret input values, keyed by placeholder key.
+ * @returns The workspace sections plus the secret env-var keys to set.
+ * @throws When a required non-secret placeholder is unresolved, or a nested
+ *   preset ref is encountered (unsupported by apply).
+ */
+export declare function presetItemsToWorkspace(preset: PresetManifest, values: Record<string, string>): WorkspaceItems;
+//# sourceMappingURL=preset-apply.d.ts.map

package/dist/cli/src/commands/preset-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-apply.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/preset-apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,oCAAoC,CAAC;AAElG,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sEAAsE;IACtE,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,6DAA6D;IAC7D,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,qEAAqE;IACrE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAKD,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,2DAA2D,CAAC;AAElG;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAexC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,cAAc,CA+BhB"}

package/dist/cli/src/commands/preset-cmd.d.ts

@@ -1,7 +1,7 @@
 /**
- * skaile preset — scaffold and validate preset YAML files.
+ * skaile preset — scaffold, validate, export, and apply preset YAML files.
  *
- * Subcommands: init, validate.
+ * Subcommands: init, validate, export, apply.
  * Delegates to @skaile/library preset module for parsing and validation.
  */
 import { Command } from "commander";

package/dist/cli/src/commands/preset-cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset-cmd.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/preset-cmd.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAsC3C"}
+{"version":3,"file":"preset-cmd.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/preset-cmd.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA0E3C"}

package/dist/cli/src/commands/preset-export.d.ts

@@ -0,0 +1,93 @@
+/**
+ * `skaile preset export` — pure core: turn a project's own `skaile.yaml`
+ * (`SkWorkspaceConfig`) into a shareable `PresetManifest`, with first-class
+ * detection and redaction of inline secrets.
+ *
+ * These helpers are intentionally free of I/O and prompting so they can be
+ * unit-tested in isolation; the Commander action in `preset-cmd.ts` owns file
+ * reads/writes, the loud stderr summary, and interactive confirmation.
+ */
+import type { LockFile, SkWorkspaceConfig, SourceEntry } from "@skaile/workspaces/core";
+import type { PresetManifest } from "@skaile/workspaces/types/manifests";
+/** One inline-secret hit: which item, where in its config, and a safe preview. */
+export interface SecretFinding {
+    /** `id` of the offending preset item (connector/mcp id). */
+    itemId: string;
+    /** Dotted path into the item's `config`, e.g. `options.dsn` or `env.TOKEN`. */
+    path: string;
+    /** Value with its secret portion masked, safe to print to a terminal. */
+    maskedValue: string;
+}
+/**
+ * Build a self-consistent {@link PresetManifest} from a workspace config.
+ *
+ * Mapping (a future `preset apply` reverses this):
+ * - `dependencies[]` → `{ ref }` items, ref copied VERBATIM (no re-pinning).
+ * - `connectors[]` → `{ id, ref: "connector:<driver>", config }` items.
+ * - `mcp_servers[]` → `{ id, ref: "mcp:<id>", config }` items.
+ *
+ * `agent_config` is deliberately NOT exported — it is personal/machine-specific
+ * (driver, model, API-cloud transport) and does not belong in a shared preset.
+ *
+ * @param config - The project-own `skaile.yaml` (NOT the merged/global config).
+ * @param name - Preset name; also the default output filename stem.
+ * @param sources - Git sources the dep items resolve from (see {@link neededSources}).
+ * @returns A manifest that passes `validatePreset` whenever it has ≥1 item.
+ */
+export declare function buildPresetFromWorkspace(config: SkWorkspaceConfig, name: string, sources?: SourceEntry[]): PresetManifest;
+/**
+ * The subset of `config.sources` a cross-repo apply must register before install.
+ *
+ * The lock's top-level `sources` list is the full **transitive** closure of every
+ * source that contributed a resolved asset, so filtering `config.sources` to it
+ * (minus the always-available factory source) captures direct + transitive deps
+ * with no drop risk. With no lock (provenance unknown), every non-factory source
+ * is kept so apply still resolves. Connectors/mcp carry no source.
+ */
+export declare function neededSources(config: SkWorkspaceConfig, lock: LockFile | null): SourceEntry[];
+/**
+ * True when `value` is a secret *reference* (indirection) rather than an inline
+ * secret — e.g. `env:DATABASE_URL`, `forge:api-key`, `pat:env:GH_TOKEN`. Such
+ * values are safe to publish and are never flagged.
+ */
+export declare function isSecretReference(value: string): boolean;
+/** True when a source URL embeds `user:pass@` credentials (private-HTTPS auth form). */
+export declare function urlHasCredentials(url: string): boolean;
+/**
+ * Strip `user:pass@` userinfo from a URL. The repo is fully identified without it
+ * (git auth on apply uses the target's own credential helper / ssh key), so an
+ * exported source URL must never carry the token into a shared preset.
+ */
+export declare function stripUrlCredentials(url: string): string;
+/**
+ * Scan every string inside each item's `config` and return inline secrets.
+ *
+ * A string is flagged when it is NOT a {@link isSecretReference} AND sits in a
+ * credential context: the inherent `auth` field, a suspicious key name, a
+ * `proto://user:pass@` URL, or a long high-entropy blob. Items without a `config`
+ * (bare deps) are skipped.
+ *
+ * Detection is **heuristic / best-effort**, not exhaustive: a short, low-entropy
+ * secret under an innocuous key name can slip through. A clean scan is not a
+ * guarantee — treat it as a safety net, not proof the file holds no secrets.
+ */
+export declare function scanInlineSecrets(preset: PresetManifest): SecretFinding[];
+/**
+ * Replace each flagged inline value with a `${INPUT:<KEY>}` placeholder and add
+ * a matching `secret` placeholder entry to the owning item. Returns a NEW preset
+ * (the input is not mutated) plus the generated placeholder keys.
+ *
+ * `<KEY>` is `<itemId>_<path>` upper-snake-cased so it is stable and readable.
+ */
+export declare function redactSecrets(preset: PresetManifest, findings: SecretFinding[]): {
+    preset: PresetManifest;
+    keys: string[];
+};
+/** Exact wording written into the file when unresolved inline secrets remain. */
+export declare const INLINE_SECRETS_HEADER = "# \u26A0\uFE0F CONTAINS INLINE SECRETS \u2014 replace with placeholders before sharing or publishing";
+/**
+ * Header comment for a preset that still holds unresolved inline secrets, or
+ * `null` when `findings` is empty (nothing left to warn about).
+ */
+export declare function secretHeaderComment(findings: SecretFinding[]): string | null;
+//# sourceMappingURL=preset-export.d.ts.map

package/dist/cli/src/commands/preset-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-export.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/preset-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAA2B,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAElG,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAW,EAAO,GAC1B,cAAc,CAoDhB;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,WAAW,EAAE,CAM7F;AAmBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAkBD,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CASzE;AAwDD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,aAAa,EAAE,GACxB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA+B5C;AAwBD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,yGACuD,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,GAAG,IAAI,CAE5E"}

package/dist/cli/src/commands/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAGL,KAAK,WAAW,EAKjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAKD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EAAE,EACtB,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,CAGzB;AAkFD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC5D;AAoBD,wBAAgB,iBAAiB,IAAI,OAAO,CAmR3C"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAGL,KAAK,WAAW,EAKjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAKD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EAAE,EACtB,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,CAGzB;AA8FD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC5D;AAoBD,wBAAgB,iBAAiB,IAAI,OAAO,CAsR3C"}

package/dist/cli/src/commands/why.d.ts

@@ -1,4 +1,22 @@
 import { Command } from "commander";
+/**
+ * Pick the right message when `am.why(ref)` returns an empty chain. Two
+ * distinct causes need different guidance:
+ *
+ * - The ref **is** a declared dependency (matches `declared` by kind+name) but
+ *   isn't in the lock file yet → tell the user to run `skaile install`.
+ * - The ref is **not** declared at all → `skaile install` cannot help, so say
+ *   plainly that nothing in `skaile.yaml` requires it.
+ *
+ * Pure and terminal-free so it can be unit-tested; the command wires the
+ * returned string into `logErr`.
+ *
+ * @param declared - Declared deps exposing `.kind` + `.name` (from `listDeclared`).
+ */
+export declare function whyEmptyMessage(ref: string, declared: Array<{
+    kind: string;
+    name: string;
+}>): string;
 /**
  * Creates the `skaile why` command.
  *

package/dist/cli/src/commands/why.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"why.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/why.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA6BxC"}
+{"version":3,"file":"why.d.ts","sourceRoot":"","sources":["../../../../cli/src/commands/why.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,MAAM,CASR;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAuCxC"}

package/dist/connectors/config.js

@@ -1,5 +1,6 @@
 export { LegacyAuthGrammarError, createCliSecretProviderChain, createForgeSecretProviderChain, loadConnectorDeclarations, resolveAuthRef, resolveBackendAuthFor } from '../chunk-BDUANIAR.js';
-import '../chunk-AZAS3FKN.js';
+import '../chunk-26YCXWCU.js';
+import '../chunk-ZAP2BDHG.js';
 import '../chunk-TJRWGMD2.js';
 import '../chunk-OUWNTFDG.js';
 import '../chunk-DZCK7GRW.js';
@@ -8,7 +9,6 @@ import '../chunk-GEEW6SY2.js';
 import '../chunk-F3HNW354.js';
 import '../chunk-MENCWIHW.js';
 import '../chunk-K5GBV4SA.js';
-import '../chunk-ZAP2BDHG.js';
 import '../chunk-JB35MVBN.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=config.js.map

package/dist/connectors/index.js

@@ -1,10 +1,11 @@
-export { AbstractConnector, BUILTIN_CONNECTOR_CATALOG, ConnectorFieldMissingError, ConnectorManager, ConnectorStartupError, FlowAdapter, LogBuffer, ManagedGitconfigCollisionError, PortPool, atomicReplaceCredential, buildConnectorPromptSection, buildSdkConnectorTools, createFsWatcher, createWorktree, defaultSpawn, ensureDirMode, ensureFleetMounted, findGitRoot, findMissingPackages, getConnector, installNpmPackages, isFleetManaged, isPackageResolvable, listConnectors, listWorktrees, registerBuiltinConnectors, removeMountBlock, renderCredentialHelperScript, tryGetConnector, worktreeRegistry, writeHelperScript, writeMountBlock } from '../chunk-PSMW5HLX.js';
+export { AbstractConnector, BUILTIN_CONNECTOR_CATALOG, ConnectorFieldMissingError, ConnectorManager, ConnectorStartupError, FlowAdapter, LogBuffer, ManagedGitconfigCollisionError, PortPool, atomicReplaceCredential, buildConnectorPromptSection, buildSdkConnectorTools, createFsWatcher, createWorktree, defaultSpawn, ensureDirMode, ensureFleetMounted, findGitRoot, findMissingPackages, getConnector, installNpmPackages, isFleetManaged, isPackageResolvable, listConnectors, listWorktrees, registerBuiltinConnectors, removeMountBlock, renderCredentialHelperScript, tryGetConnector, worktreeRegistry, writeHelperScript, writeMountBlock } from '../chunk-GWDZW44L.js';
 export { EnvSecretProvider, ForgeSecretProvider, InMemorySecretProvider, LegacyAuthGrammarError, LockedSecretProvider, OAuthRequiredError, PreMintedSecretProvider, SecretProviderChain, createCliSecretProviderChain, createForgeSecretProviderChain, deriveSingleMaterializedConnectorDeclaration, fromMaterializedConnectorMd, loadConnectorDeclarations, loadMaterializedConnectorDeclarations, resolveAuthRef, resolveBackendAuthFor } from '../chunk-BDUANIAR.js';
 import '../chunk-6E6PKKAD.js';
-import '../chunk-SKADPHAM.js';
+import '../chunk-4N5XR5DQ.js';
 import '../chunk-DEYYRFQU.js';
 import '../chunk-IFGTRL2I.js';
-import '../chunk-AZAS3FKN.js';
+import '../chunk-26YCXWCU.js';
+import '../chunk-ZAP2BDHG.js';
 import '../chunk-TJRWGMD2.js';
 import '../chunk-OUWNTFDG.js';
 import '../chunk-DZCK7GRW.js';
@@ -13,7 +14,6 @@ import '../chunk-GEEW6SY2.js';
 import '../chunk-F3HNW354.js';
 import '../chunk-MENCWIHW.js';
 import '../chunk-K5GBV4SA.js';
-import '../chunk-ZAP2BDHG.js';
 import '../chunk-JB35MVBN.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js

@@ -1,4 +1,5 @@
-export { ALL_PROVIDERS, ManifestYamlEditor, SETTINGS_DEFAULTS, WorkspaceYamlEditor, applyPatch, buildLockFile, checkAgentSkillConformance, computeHash, detectEnvApiKeys, extractForPatch, generatePatch, globalSettingsPath, listPatches, loadSettings, mapLegacyFields, maskApiKey, migrateSettings, portableSpawn, portableSpawnSync, projectSettingsPath, providerEnvKey, readLock, readPatch, readPluginsLockSlice, resolveAllKeys, resolveApiKey, resolveSettings, savePatch, saveSettings, verifyLock, walkForSettings, writeLock, writePluginsLockSlice } from '../chunk-AZAS3FKN.js';
+export { ALL_PROVIDERS, ManifestYamlEditor, SETTINGS_DEFAULTS, WorkspaceYamlEditor, applyPatch, buildLockFile, checkAgentSkillConformance, computeHash, detectEnvApiKeys, extractForPatch, generatePatch, globalSettingsPath, listPatches, loadSettings, mapLegacyFields, maskApiKey, migrateSettings, portableSpawn, portableSpawnSync, projectSettingsPath, providerEnvKey, readLock, readPatch, readPluginsLockSlice, resolveAllKeys, resolveApiKey, resolveSettings, savePatch, saveSettings, verifyLock, walkForSettings, writeLock, writePluginsLockSlice } from '../chunk-26YCXWCU.js';
+export { ASSET_KIND_DIRS, assetSearchDirs, detectAiResources, detectDomains, detectMonorepoRoot } from '../chunk-ZAP2BDHG.js';
 export { FACTORY_ASSETS_REPO_NAME, factoryAssetRoots, resolveFactoryAssetsRoot, resolveFactoryAssetsRootOrNull, resolvePackagedAssetsDir, resolveRuntimeAssets, resolveWorkspacesPackageRoot } from '../chunk-TJRWGMD2.js';
 export { COMPACTION_DEFAULTS, CanonicalRefConflictError, DEFAULT_RECIPE_ATTR, SKAILE_YAML_DEFAULT, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, __resetCacheMigrationMemo, buildProvenanceIndex, checkRepoStatus, checkoutPin, cloneRepo, cloudConfigFromProfile, decodeSkaileYaml, deriveSingleMaterializedMcpDeclaration, encodeSkaileYaml, ensureRepo, findWorkspaceRoot, getGlobalCacheDir, getRepoCommit, globalCacheRoot, globalSkaileDir, linkRepo, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, mergeLegacyEntriesInto, mergeSkWorkspaceConfigs, migrateLegacyDir, normalizeConfig, pullRepo, readLinks, resolveAgentDir, resolveAll, resolveAsset, resolveGlobalBackends, resolveGlobalSkWorkspaceConfig, resolveSkWorkspaceConfig, resolveSourcePublisher, saveSkWorkspaceConfig, scanRepo, sourceCacheKey, sourceShortName, stageMaterializedSkills, unlinkRepo, validateAssetRecipeAttr, validateAssetRecipeFlake, workspaceConfigFilename, writeLinks } from '../chunk-OUWNTFDG.js';
 export { SKAILE_MANIFEST_FILENAME, decodeSkaileManifest, encodeSkaileManifest, loadSkPublishManifest, saveSkPublishManifest } from '../chunk-DZCK7GRW.js';
@@ -7,7 +8,6 @@ export { ASSET_KINDS, ASSET_NAME_HINT, INDIVIDUAL_KINDS, assetRefToDep, assetRef
 export { deployedBase, deployedDir, isDeployed } from '../chunk-F3HNW354.js';
 export { DRIVER_TARGETS, SUPPORTED_DRIVER_TARGETS, globalBackendRoot } from '../chunk-MENCWIHW.js';
 export { DRIVER_DEFAULTS, resolveDriverPaths } from '../chunk-K5GBV4SA.js';
-export { ASSET_KIND_DIRS, assetSearchDirs, detectAiResources, detectDomains, detectMonorepoRoot } from '../chunk-ZAP2BDHG.js';
 export { LogStore, LogStoreDisabledError, NoOpSink, OnLogBridgeSink, SqliteSink, StdoutSink, WsLogSink, createLogStoreFromConfig, createLogger, getLogStore, normalizeError, openSqlite, registerLogStore, resetLogStore, resolveLogStoreConfig, sanitizeData } from '../chunk-JB35MVBN.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map

package/dist/core/src/workspace-yaml-editor.d.ts

@@ -15,7 +15,7 @@
  *   editor.save()
  */
 import { Document } from "yaml";
-import type { AgentConfigProfile, ConnectorDeclaration, OverrideEntry, SourceEntry, StoreEntry } from "./workspace-config.js";
+import type { AgentConfigProfile, ConnectorDeclaration, McpServerDeclaration, OverrideEntry, SourceEntry, StoreEntry } from "./workspace-config.js";
 /**
  * Comment-preserving editor for `skaile.yaml` files.
  * Uses the `yaml` library's Document AST so untouched sections remain byte-identical.
@@ -59,6 +59,19 @@ export declare class WorkspaceYamlEditor {
     setConnector(connector: ConnectorDeclaration): void;
     /** Remove a connector by id. */
     removeConnector(id: string): boolean;
+    /**
+     * Add or replace an mcp server entry, matched by `id`.
+     * Mirrors {@link setConnector}: an existing entry with the same `id` is
+     * replaced in place; otherwise the declaration is appended.
+     */
+    setMcpServer(mcp: McpServerDeclaration): void;
+    /**
+     * Append a dependency ref to `dependencies:`, deduped by exact ref string.
+     *
+     * @param ref - Canonical dependency ref (e.g. `skill:@skaile/foo#1.0.0`).
+     * @returns `true` when the ref was newly added, `false` when it was already present.
+     */
+    addDependency(ref: string): boolean;
     /** Get all `plugins:` specifiers. */
     getPlugins(): string[];
     /**

package/dist/core/src/workspace-yaml-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-yaml-editor.d.ts","sourceRoot":"","sources":["../../../core/src/workspace-yaml-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,QAAQ,EAA6C,MAAM,MAAM,CAAC;AAC3E,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,UAAU,EACX,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAW;IAEtB,OAAO;IAKP,yCAAyC;IACzC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IASlD,qEAAqE;IACrE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAKpD,2EAA2E;IAC3E,IAAI,IAAI,IAAI;IAIZ,iEAAiE;IACjE,QAAQ,IAAI,MAAM;IAMlB,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS;IAKpD,oCAAoC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrD;;;OAGG;IACH,cAAc,CAAC,OAAO,SAAY,GAAG,kBAAkB,GAAG,SAAS;IAOnE;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAoB1E;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5D,OAAO,CAAC,sBAAsB;IAQ9B,0BAA0B;IAC1B,aAAa,IAAI,oBAAoB,EAAE;IAMvC,uCAAuC;IACvC,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAwBnD,gCAAgC;IAChC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiBpC,qCAAqC;IACrC,UAAU,IAAI,MAAM,EAAE;IAWtB;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO;IAoB/D;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO;IAiBlE,8CAA8C;IAC9C,UAAU,IAAI,WAAW,EAAE;IAM3B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAkBnC,4EAA4E;IAC5E,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAelC,uCAAuC;IACvC,SAAS,IAAI,UAAU,EAAE;IAMzB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAkBjC,2EAA2E;IAC3E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAejC,0DAA0D;IAC1D,YAAY,IAAI,aAAa,EAAE;IAM/B,yDAAyD;IACzD,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAkBvC,+EAA+E;IAC/E,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAepC,kEAAkE;IAClE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;CACF"}
+{"version":3,"file":"workspace-yaml-editor.d.ts","sourceRoot":"","sources":["../../../core/src/workspace-yaml-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,QAAQ,EAA6C,MAAM,MAAM,CAAC;AAC3E,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,UAAU,EACX,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAW;IAEtB,OAAO;IAKP,yCAAyC;IACzC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IASlD,qEAAqE;IACrE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAKpD,2EAA2E;IAC3E,IAAI,IAAI,IAAI;IAIZ,iEAAiE;IACjE,QAAQ,IAAI,MAAM;IAMlB,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS;IAKpD,oCAAoC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrD;;;OAGG;IACH,cAAc,CAAC,OAAO,SAAY,GAAG,kBAAkB,GAAG,SAAS;IAOnE;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAoB1E;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5D,OAAO,CAAC,sBAAsB;IAQ9B,0BAA0B;IAC1B,aAAa,IAAI,oBAAoB,EAAE;IAMvC,uCAAuC;IACvC,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAwBnD,gCAAgC;IAChC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiBpC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI;IA0B7C;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAgBnC,qCAAqC;IACrC,UAAU,IAAI,MAAM,EAAE;IAWtB;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO;IAoB/D;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO;IAiBlE,8CAA8C;IAC9C,UAAU,IAAI,WAAW,EAAE;IAM3B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAkBnC,4EAA4E;IAC5E,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAelC,uCAAuC;IACvC,SAAS,IAAI,UAAU,EAAE;IAMzB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAkBjC,2EAA2E;IAC3E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAejC,0DAA0D;IAC1D,YAAY,IAAI,aAAa,EAAE;IAM/B,yDAAyD;IACzD,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAkBvC,+EAA+E;IAC/E,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAepC,kEAAkE;IAClE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;CACF"}

package/dist/deploy/index.js

@@ -1,5 +1,6 @@
 import { makeDeployHandle, pluginRegistry } from '../chunk-6E6PKKAD.js';
-import { portableSpawnSync, portableSpawn } from '../chunk-AZAS3FKN.js';
+import { portableSpawnSync, portableSpawn } from '../chunk-26YCXWCU.js';
+import '../chunk-ZAP2BDHG.js';
 import '../chunk-TJRWGMD2.js';
 import '../chunk-OUWNTFDG.js';
 import '../chunk-DZCK7GRW.js';
@@ -8,7 +9,6 @@ import '../chunk-GEEW6SY2.js';
 import '../chunk-F3HNW354.js';
 import '../chunk-MENCWIHW.js';
 import '../chunk-K5GBV4SA.js';
-import '../chunk-ZAP2BDHG.js';
 import '../chunk-JB35MVBN.js';
 import '../chunk-NSBPE2FW.js';
 import * as z from 'zod';

package/dist/discovery/index.js

@@ -1,9 +1,9 @@
-export { AGENT_COMPANION_DIRS, AssetKindRegistry, BUILTIN_PROVIDERS, DEFAULT_ATOMIZATION_POLICY, DOMAIN_MD_FILENAME, SEMVER_RE, SKILL_COMPANION_DIRS, SourceConfigSchema, VERSION, agentProvider, assignDomain, buildDomainIndex, buildRequiresGraph, closeOverReferences, computeDeterministicHash, computeDeterministicHashDetailed, connectorProvider, contractProvider, createDefaultRegistry, createNodeAssetFs, decodeManifestSourceConfig, detectCycles, discoverAssetsInTree, discoverAssetsInTreeEntries, discoverFromManifest, extractPathCandidates, extractRequires, extractSlashCommands, isDomainMdPath, isExcludedDevPath, isManifestMode, lintUncoveredReferences, loadMergedSourceConfig, loadSourceConfig, manifestToSourceConfig, mcpServerProvider, mergeSourceConfigs, parseDomainMd, parseSourceConfig, personaProvider, presetProvider, promptProvider, readManifestSourceConfig, rulesetProvider, scanAssetReferences, scanSlashCommandNames, skillProvider, validateDomains, validateSourceConfig } from '../chunk-BZMTR5WW.js';
+export { AGENT_COMPANION_DIRS, AssetKindRegistry, BUILTIN_PROVIDERS, DEFAULT_ATOMIZATION_POLICY, DOMAIN_MD_FILENAME, SEMVER_RE, SKILL_COMPANION_DIRS, SourceConfigSchema, VERSION, agentProvider, assignDomain, buildDomainIndex, buildRequiresGraph, closeOverReferences, computeDeterministicHash, computeDeterministicHashDetailed, connectorProvider, contractProvider, createDefaultRegistry, createNodeAssetFs, decodeManifestSourceConfig, detectCycles, discoverAssetsInTree, discoverAssetsInTreeEntries, discoverFromManifest, extractPathCandidates, extractRequires, extractSlashCommands, isDomainMdPath, isExcludedDevPath, isManifestMode, lintUncoveredReferences, loadMergedSourceConfig, loadSourceConfig, manifestToSourceConfig, mcpServerProvider, mergeSourceConfigs, parseDomainMd, parseSourceConfig, personaProvider, presetProvider, promptProvider, readManifestSourceConfig, rulesetProvider, scanAssetReferences, scanSlashCommandNames, skillProvider, validateDomains, validateSourceConfig } from '../chunk-B6SSXVF2.js';
 import '../chunk-JXT46QFC.js';
 import '../chunk-DZCK7GRW.js';
 import '../chunk-BQCGFPHW.js';
 import '../chunk-GEEW6SY2.js';
-import '../chunk-GB4SEEK4.js';
+import '../chunk-IRORTHGA.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{ensure-sources-4BAJGJRK.js → ensure-sources-CHC7X7AJ.js}

@@ -1,7 +1,9 @@
-import { logErr, logOk, logInfo } from './chunk-5XS3BFJS.js';
-import './chunk-OBSSORCE.js';
-import './chunk-WFEPI5LA.js';
-import { WorkspaceYamlEditor } from './chunk-AZAS3FKN.js';
+import { logErr, logOk, logInfo } from './chunk-DNFIKRO6.js';
+import './chunk-X57AMTAH.js';
+import './chunk-LCTRCWBK.js';
+import './chunk-CGYEHQOX.js';
+import { WorkspaceYamlEditor } from './chunk-26YCXWCU.js';
+import './chunk-ZAP2BDHG.js';
 import './chunk-TJRWGMD2.js';
 import { sourceCacheKey, sourceShortName, getGlobalCacheDir } from './chunk-OUWNTFDG.js';
 import './chunk-DZCK7GRW.js';
@@ -10,13 +12,11 @@ import './chunk-GEEW6SY2.js';
 import './chunk-F3HNW354.js';
 import './chunk-MENCWIHW.js';
 import './chunk-K5GBV4SA.js';
-import './chunk-ZAP2BDHG.js';
 import './chunk-JB35MVBN.js';
 import './chunk-KTBKW2FI.js';
 import './chunk-UQ6LFBPZ.js';
-import './chunk-XKARS6EE.js';
-import './chunk-GB4SEEK4.js';
-import './chunk-CGYEHQOX.js';
+import './chunk-IEX5YV4R.js';
+import './chunk-IRORTHGA.js';
 import './chunk-NSBPE2FW.js';
 import { spawnSync } from 'child_process';
 import { existsSync, mkdirSync } from 'fs';
@@ -80,5 +80,5 @@ function ensureSourcesCloned(projectDir, opts = {}) {
 }
 
 export { ensureSourcesCloned };
-//# sourceMappingURL=ensure-sources-4BAJGJRK.js.map
-//# sourceMappingURL=ensure-sources-4BAJGJRK.js.map
+//# sourceMappingURL=ensure-sources-CHC7X7AJ.js.map
+//# sourceMappingURL=ensure-sources-CHC7X7AJ.js.map

package/dist/{ensure-sources-4BAJGJRK.js.map → ensure-sources-CHC7X7AJ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../cli/src/ensure-sources.ts"],"names":[],"mappings":"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","file":"ensure-sources-4BAJGJRK.js","sourcesContent":["/**\n * ensure-sources.ts — hydrate the `~/.skaile/cache/sources/` clone cache from a\n * project's `skaile.yaml` `sources:` entries.\n *\n * Called by `skaile init` (idempotent: no-op when no sources declared) and\n * `skaile install` so checking out a project pulls its source clones onto\n * the local machine.\n */\n\nimport { spawnSync } from \"node:child_process\";\nimport { existsSync, mkdirSync } from \"node:fs\";\nimport * as path from \"node:path\";\nimport {\n  getGlobalCacheDir,\n  type SourceEntry,\n  sourceCacheKey,\n  sourceShortName,\n  WorkspaceYamlEditor,\n} from \"@skaile/workspaces/core\";\nimport { logErr, logInfo, logOk } from \"./helpers.ts\";\n\nfunction sourceClonePath(key: string): string {\n  return path.join(getGlobalCacheDir(), key);\n}\n\nexport interface EnsureResult {\n  cloned: string[];\n  cached: string[];\n  failed: string[];\n}\n\n/** Load `sources:` from a project's `skaile.yaml`, or `null` when unavailable. */\nfunction loadProjectSources(yamlPath: string, quiet: boolean): SourceEntry[] | null {\n  try {\n    return WorkspaceYamlEditor.load(yamlPath).getSources();\n  } catch (err) {\n    if (!quiet) {\n      logErr(`Could not read ${yamlPath}: ${err instanceof Error ? err.message : String(err)}`);\n    }\n    return null;\n  }\n}\n\n/**\n * Hydrate a single source entry into `result`: skip when already cached,\n * otherwise clone and record success/failure. Mutates `result` in place.\n */\nfunction hydrateSourceEntry(entry: SourceEntry, quiet: boolean, result: EnsureResult): void {\n  const key = sourceCacheKey(entry.url);\n  const slug = sourceShortName(entry.url);\n  const dest = sourceClonePath(key);\n  if (existsSync(dest)) {\n    result.cached.push(slug);\n    return;\n  }\n  mkdirSync(path.dirname(dest), { recursive: true });\n  const args = [\"clone\", entry.url, dest];\n  if (entry.pin) args.splice(1, 0, \"--branch\", entry.pin);\n  const clone = spawnSync(\"git\", args, { stdio: quiet ? \"pipe\" : \"inherit\" });\n  if (clone.status !== 0) {\n    result.failed.push(slug);\n    if (quiet) {\n      logErr(`git clone failed for ${entry.url}`);\n    }\n    return;\n  }\n  result.cloned.push(slug);\n}\n\n/** Log a full-hydrate summary of cloned + reused-cached entries. */\nfunction logHydrateSummary(result: EnsureResult): void {\n  for (const n of result.cloned) logOk(`Cloned source \"${n}\".`);\n  if (result.cached.length > 0) {\n    logInfo(`Reused cached clones: ${result.cached.join(\", \")}`);\n  }\n}\n\n/**\n * Walk `projectDir/skaile.yaml` `sources:` and clone any entries whose\n * clone directory does not yet exist under `~/.skaile/cache/sources/`. Existing\n * clones are left untouched — this is hydration, not sync.\n *\n * Quiet by default: when `quiet: true` the helper only prints failures.\n * On full hydrate (`quiet: false`) it logs each cloned/cached entry.\n */\nexport function ensureSourcesCloned(\n  projectDir: string,\n  opts: { quiet?: boolean } = {},\n): EnsureResult {\n  const result: EnsureResult = { cloned: [], cached: [], failed: [] };\n  const yamlPath = path.join(projectDir, \"skaile.yaml\");\n  if (!existsSync(yamlPath)) return result;\n\n  const quiet = opts.quiet ?? false;\n  const sources = loadProjectSources(yamlPath, quiet);\n  if (sources === null) return result;\n  if (sources.length === 0) return result;\n\n  for (const entry of sources) {\n    hydrateSourceEntry(entry, quiet, result);\n  }\n\n  if (!quiet) {\n    logHydrateSummary(result);\n  }\n\n  return result;\n}\n"]}
+{"version":3,"sources":["../cli/src/ensure-sources.ts"],"names":[],"mappings":"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","file":"ensure-sources-CHC7X7AJ.js","sourcesContent":["/**\n * ensure-sources.ts — hydrate the `~/.skaile/cache/sources/` clone cache from a\n * project's `skaile.yaml` `sources:` entries.\n *\n * Called by `skaile init` (idempotent: no-op when no sources declared) and\n * `skaile install` so checking out a project pulls its source clones onto\n * the local machine.\n */\n\nimport { spawnSync } from \"node:child_process\";\nimport { existsSync, mkdirSync } from \"node:fs\";\nimport * as path from \"node:path\";\nimport {\n  getGlobalCacheDir,\n  type SourceEntry,\n  sourceCacheKey,\n  sourceShortName,\n  WorkspaceYamlEditor,\n} from \"@skaile/workspaces/core\";\nimport { logErr, logInfo, logOk } from \"./helpers.ts\";\n\nfunction sourceClonePath(key: string): string {\n  return path.join(getGlobalCacheDir(), key);\n}\n\nexport interface EnsureResult {\n  cloned: string[];\n  cached: string[];\n  failed: string[];\n}\n\n/** Load `sources:` from a project's `skaile.yaml`, or `null` when unavailable. */\nfunction loadProjectSources(yamlPath: string, quiet: boolean): SourceEntry[] | null {\n  try {\n    return WorkspaceYamlEditor.load(yamlPath).getSources();\n  } catch (err) {\n    if (!quiet) {\n      logErr(`Could not read ${yamlPath}: ${err instanceof Error ? err.message : String(err)}`);\n    }\n    return null;\n  }\n}\n\n/**\n * Hydrate a single source entry into `result`: skip when already cached,\n * otherwise clone and record success/failure. Mutates `result` in place.\n */\nfunction hydrateSourceEntry(entry: SourceEntry, quiet: boolean, result: EnsureResult): void {\n  const key = sourceCacheKey(entry.url);\n  const slug = sourceShortName(entry.url);\n  const dest = sourceClonePath(key);\n  if (existsSync(dest)) {\n    result.cached.push(slug);\n    return;\n  }\n  mkdirSync(path.dirname(dest), { recursive: true });\n  const args = [\"clone\", entry.url, dest];\n  if (entry.pin) args.splice(1, 0, \"--branch\", entry.pin);\n  const clone = spawnSync(\"git\", args, { stdio: quiet ? \"pipe\" : \"inherit\" });\n  if (clone.status !== 0) {\n    result.failed.push(slug);\n    if (quiet) {\n      logErr(`git clone failed for ${entry.url}`);\n    }\n    return;\n  }\n  result.cloned.push(slug);\n}\n\n/** Log a full-hydrate summary of cloned + reused-cached entries. */\nfunction logHydrateSummary(result: EnsureResult): void {\n  for (const n of result.cloned) logOk(`Cloned source \"${n}\".`);\n  if (result.cached.length > 0) {\n    logInfo(`Reused cached clones: ${result.cached.join(\", \")}`);\n  }\n}\n\n/**\n * Walk `projectDir/skaile.yaml` `sources:` and clone any entries whose\n * clone directory does not yet exist under `~/.skaile/cache/sources/`. Existing\n * clones are left untouched — this is hydration, not sync.\n *\n * Quiet by default: when `quiet: true` the helper only prints failures.\n * On full hydrate (`quiet: false`) it logs each cloned/cached entry.\n */\nexport function ensureSourcesCloned(\n  projectDir: string,\n  opts: { quiet?: boolean } = {},\n): EnsureResult {\n  const result: EnsureResult = { cloned: [], cached: [], failed: [] };\n  const yamlPath = path.join(projectDir, \"skaile.yaml\");\n  if (!existsSync(yamlPath)) return result;\n\n  const quiet = opts.quiet ?? false;\n  const sources = loadProjectSources(yamlPath, quiet);\n  if (sources === null) return result;\n  if (sources.length === 0) return result;\n\n  for (const entry of sources) {\n    hydrateSourceEntry(entry, quiet, result);\n  }\n\n  if (!quiet) {\n    logHydrateSummary(result);\n  }\n\n  return result;\n}\n"]}

package/dist/factory-assets/connectors/box.js

@@ -1,10 +1,11 @@
-export { BoxConnector, createConnector4 as createConnector } from '../../chunk-PSMW5HLX.js';
+export { BoxConnector, createConnector4 as createConnector } from '../../chunk-GWDZW44L.js';
 import '../../chunk-BDUANIAR.js';
 import '../../chunk-6E6PKKAD.js';
-import '../../chunk-SKADPHAM.js';
+import '../../chunk-4N5XR5DQ.js';
 import '../../chunk-DEYYRFQU.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-AZAS3FKN.js';
+import '../../chunk-26YCXWCU.js';
+import '../../chunk-ZAP2BDHG.js';
 import '../../chunk-TJRWGMD2.js';
 import '../../chunk-OUWNTFDG.js';
 import '../../chunk-DZCK7GRW.js';
@@ -13,7 +14,6 @@ import '../../chunk-GEEW6SY2.js';
 import '../../chunk-F3HNW354.js';
 import '../../chunk-MENCWIHW.js';
 import '../../chunk-K5GBV4SA.js';
-import '../../chunk-ZAP2BDHG.js';
 import '../../chunk-JB35MVBN.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=box.js.map

package/dist/factory-assets/connectors/deploy.js

@@ -1,10 +1,11 @@
-export { DeployConnector, createConnector2 as createConnector } from '../../chunk-PSMW5HLX.js';
+export { DeployConnector, createConnector2 as createConnector } from '../../chunk-GWDZW44L.js';
 import '../../chunk-BDUANIAR.js';
 import '../../chunk-6E6PKKAD.js';
-import '../../chunk-SKADPHAM.js';
+import '../../chunk-4N5XR5DQ.js';
 import '../../chunk-DEYYRFQU.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-AZAS3FKN.js';
+import '../../chunk-26YCXWCU.js';
+import '../../chunk-ZAP2BDHG.js';
 import '../../chunk-TJRWGMD2.js';
 import '../../chunk-OUWNTFDG.js';
 import '../../chunk-DZCK7GRW.js';
@@ -13,7 +14,6 @@ import '../../chunk-GEEW6SY2.js';
 import '../../chunk-F3HNW354.js';
 import '../../chunk-MENCWIHW.js';
 import '../../chunk-K5GBV4SA.js';
-import '../../chunk-ZAP2BDHG.js';
 import '../../chunk-JB35MVBN.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=deploy.js.map

package/dist/factory-assets/connectors/devserver.js

@@ -1,10 +1,11 @@
-export { DevServerConnector, createConnector3 as createConnector } from '../../chunk-PSMW5HLX.js';
+export { DevServerConnector, createConnector3 as createConnector } from '../../chunk-GWDZW44L.js';
 import '../../chunk-BDUANIAR.js';
 import '../../chunk-6E6PKKAD.js';
-import '../../chunk-SKADPHAM.js';
+import '../../chunk-4N5XR5DQ.js';
 import '../../chunk-DEYYRFQU.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-AZAS3FKN.js';
+import '../../chunk-26YCXWCU.js';
+import '../../chunk-ZAP2BDHG.js';
 import '../../chunk-TJRWGMD2.js';
 import '../../chunk-OUWNTFDG.js';
 import '../../chunk-DZCK7GRW.js';
@@ -13,7 +14,6 @@ import '../../chunk-GEEW6SY2.js';
 import '../../chunk-F3HNW354.js';
 import '../../chunk-MENCWIHW.js';
 import '../../chunk-K5GBV4SA.js';
-import '../../chunk-ZAP2BDHG.js';
 import '../../chunk-JB35MVBN.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=devserver.js.map

package/dist/factory-assets/connectors/flow/adapter.js

@@ -1,10 +1,11 @@
-export { FlowAdapter, createConnector } from '../../../chunk-PSMW5HLX.js';
+export { FlowAdapter, createConnector } from '../../../chunk-GWDZW44L.js';
 import '../../../chunk-BDUANIAR.js';
 import '../../../chunk-6E6PKKAD.js';
-export { isBlocking } from '../../../chunk-SKADPHAM.js';
+export { isBlocking } from '../../../chunk-4N5XR5DQ.js';
 import '../../../chunk-DEYYRFQU.js';
 import '../../../chunk-IFGTRL2I.js';
-import '../../../chunk-AZAS3FKN.js';
+import '../../../chunk-26YCXWCU.js';
+import '../../../chunk-ZAP2BDHG.js';
 import '../../../chunk-TJRWGMD2.js';
 import '../../../chunk-OUWNTFDG.js';
 import '../../../chunk-DZCK7GRW.js';
@@ -13,7 +14,6 @@ import '../../../chunk-GEEW6SY2.js';
 import '../../../chunk-F3HNW354.js';
 import '../../../chunk-MENCWIHW.js';
 import '../../../chunk-K5GBV4SA.js';
-import '../../../chunk-ZAP2BDHG.js';
 import '../../../chunk-JB35MVBN.js';
 import '../../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=adapter.js.map

package/dist/factory-assets/connectors/flow/engine/engine.d.ts

@@ -82,7 +82,10 @@ export declare function isBlocking(status: NodeStatus): boolean;
  * @param completedIds - Set of node IDs already known to be complete before this call.
  * @param skippedIds - Set of node IDs that were explicitly skipped. Defaults to an empty set.
  * @returns Array of node IDs whose hard dependencies are now fully satisfied and that
- *   were not already available before `justCompleted` finished.
+ *   were not already available before `justCompleted` finished. Unlike {@link skillNodes}-based
+ *   helpers, this walks raw edge targets and does not filter by node type — if a `group`,
+ *   `sub-flow`, or `router` node is a direct successor, its ID can appear here. Callers that
+ *   dispatch these IDs as runnable skill nodes are responsible for filtering non-`'skill'` IDs.
  * @docLink packages/flow-engine/concepts#resolve-next-nodes
  */
 export declare function resolveNextNodes(flow: FlowDefinition, justCompleted: string, completedIds: Set<string>, skippedIds?: Set<string>): string[];

package/dist/factory-assets/connectors/flow/engine/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAGd,SAAS,EACT,qBAAqB,EAErB,UAAU,EACX,MAAM,YAAY,CAAC;AA+BpB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,EACnC,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,SAAS,CA+EX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC5C,SAAS,CA6DX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,MAAM,EAAE,CAmBV;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAgB1F"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAGd,SAAS,EACT,qBAAqB,EAErB,UAAU,EACX,MAAM,YAAY,CAAC;AA+BpB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,EACnC,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,SAAS,CA+EX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC5C,SAAS,CA6DX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,MAAM,EAAE,CAmBV;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAgB1F"}

package/dist/factory-assets/connectors/flow/engine/types.d.ts

@@ -14,8 +14,26 @@ export type EdgeType = "flow" | "parallel" | "optional";
 /**
  * A single node in a flow definition.
  *
- * Nodes with `type === 'group'` are visual containers used by the flow editor — the engine
- * filters them out before any computation. Only `type === 'skill'` nodes are executed.
+ * Four node kinds exist:
+ * - `'skill'`    — executed: the runner invokes `data.skill`; completion is reported via
+ *                  the standard `complete_node` tool call. The only kind the engine tracks
+ *                  in {@link NodeState} today (see below).
+ * - `'sub-flow'` — non-executable: no skill runs. Conceptually completes when the delegated
+ *                  flow named by `data.flow` finishes — driving that nested run is entirely
+ *                  a host/orchestrator concern, not something this package implements.
+ * - `'router'`   — non-executable: no skill runs. Conceptually completes when a route from
+ *                  `data.routes` is chosen. `data.routes` is evaluated in order — the first
+ *                  entry whose `condition` holds wins; `condition: "default"` is a
+ *                  catch-all; `target: null` means "choose to skip".
+ * - `'group'`    — visual only: a canvas container used by the flow editor.
+ *
+ * Today the engine (`computeFlowState`, `computeFlowStateFromSnapshots`,
+ * `computeSkippable`) tracks only `'skill'` nodes — `'sub-flow'`, `'router'`, and `'group'`
+ * are all excluded from {@link NodeState}, edge computation, and dependency blocking, the
+ * same as pure visual containers. `'sub-flow'` and `'router'` are recognized node kinds so
+ * consumers don't need to cast around the type, and their intended completion semantics are
+ * documented here, but wiring them into the engine's dependency graph (so dependents
+ * actually wait on them) is downstream/future work.
  *
  * Note: `node.id` is the canvas identifier; `node.data.skill` is the skill that runs.
  * They may differ when the same skill is aliased to multiple canvas positions.
@@ -26,10 +44,11 @@ export interface FlowNode {
     /** Canvas-unique node identifier. Used as the key in completed/running/skipped sets. */
     id: string;
     /**
-     * Node kind. `'skill'` nodes are executed by the runner; `'group'` nodes are
-     * visual containers only and are ignored by the engine.
+     * Node kind — see the type-level doc above for the full semantics of each kind. Only
+     * `'skill'` is tracked by the engine today; `'sub-flow'`, `'router'`, and `'group'` are
+     * all ignored by `computeFlowState` / `computeFlowStateFromSnapshots` / `computeSkippable`.
      */
-    type: "skill" | "group";
+    type: "skill" | "group" | "sub-flow" | "router";
     /** ID of the parent group node when this node is nested inside a group container. */
     parentNode?: string;
     /** Visual position on the canvas — not used by the engine. */
@@ -70,6 +89,22 @@ export interface FlowNode {
             /** File paths to skip checking (guaranteed by prior nodes in this flow). */
             skip_checks?: string[];
         };
+        /** `'sub-flow'` nodes only: ID of the delegated flow whose completion completes this node. */
+        flow?: string;
+        /**
+         * `'router'` nodes only: ordered routing table. Evaluated top to bottom — the first
+         * entry whose `condition` holds is taken. `condition: "default"` matches unconditionally
+         * (a catch-all, conventionally placed last). `target: null` means the route resolves to
+         * "skip" rather than to another node. This package does not itself parse or evaluate
+         * `condition` — it is an opaque string whose format (expression language, predicate
+         * syntax, or named enum value) is defined by whichever host/orchestrator evaluates
+         * routes. See `docs/flow-execution.md#node-types` — concept-forge's
+         * `shared/flow-extended.ts` is a reference implementation.
+         */
+        routes?: Array<{
+            condition: string;
+            target: string | null;
+        }>;
         [key: string]: any;
     };
 }
@@ -278,7 +313,7 @@ export interface NodeState {
 export interface FlowState {
     /** ID of the flow this state was computed from (`FlowDefinition.id`). */
     flowId: string;
-    /** Per-node state for every skill node in the flow (group nodes excluded). */
+    /** Per-node state for every skill node in the flow (group, sub-flow, and router nodes excluded). */
     nodes: NodeState[];
     /** IDs of nodes whose status is `'available'` — ready to be dispatched by the runner. */
     available: string[];