@skaile/workspaces 5.5.0 → 5.6.1

package/CHANGELOG.md

@@ -1,5 +1,100 @@
 # Changelog
 
+## 5.6.1
+
+### Patch Changes
+
+- [#1031](https://github.com/skaile-ai/workspaces/pull/1031) [`377e0d6`](https://github.com/skaile-ai/workspaces/commit/377e0d6736eb01d828aaf74764e09fd82db96b53) Thanks [@mortegro](https://github.com/mortegro)! - - `skaile migrate agents` no longer copies a legacy `requires[].name` such as `Code Reviewer` or `foo.bar` verbatim into `composes[].as`, which failed validation and got the whole `agent.yaml` skipped. The name is slugified (`code-reviewer`, `foo-bar`) with a note naming the original; a name with no valid slug, or one that collides with another alias in the same agent, omits `as` and is listed under the plan's manual section.
+
+  - Tests now pin the run controller's cancel races: a cancel while a run is moving from `queued` to `running`, and a cancel while the nested session is being created or started, each end `cancelled`, settle `agent.result { wait: true }` and dispose the half-started session.
+
+- [#1034](https://github.com/skaile-ai/workspaces/pull/1034) [`85bf2cc`](https://github.com/skaile-ai/workspaces/commit/85bf2cc7dc8517f90568ac4bdb26299db617b8d3) Thanks [@mortegro](https://github.com/mortegro)! - - `skaile install` deploys every file the lock records for an asset from a `sources:` clone again. Since 5.6.0 such assets were copied through the kind's convention filter, so a skill's `.gitignore` or `resources/` dir was dropped while `skaile.lock.yaml` still listed it. Store-staged assets already copied their full file list; both paths now share it.
+  - A re-install compares every deployed file of an asset, not only its manifest, so a deleted or stale companion file (`scripts/`, `resources/`, dotfiles) is restored even when `SKILL.md` is unchanged.
+
+## 5.6.0
+
+### Minor Changes
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - The runner now resolves one agent instance per session. `resolveAgentInstance({ instanceId, instance, asset, projectDir, source?, host?, ... })` (`@skaile/workspaces/runner`) replaces `resolveAgentComposition` and returns a `ResolvedAgentInstance`: inline blocks, discoverable entries, `subagents: { delegate, run }`, `memoryBlocks`, effective `triggers`, `io`, connector `slots`, `warnings` and a stable `revisionHash`. The convention files (`SOUL.md`, `RULES.md`, `DUTIES.md`, `knowledge/`) compose first as implicit items; a standalone `persona` / `ruleset` composes like its convention file. `kind: agent` items default to `delegate` when the driver has native sub-agents, else `run`. Memory blocks take the instance's `memory.scope`, are seeded from their `source` file and take host content when the host provides it; triggers merge by id with the instance's overrides (`enabled: false` drops one). A required `capabilities[]` entry that the host, the composition and the bound connector slots do not provide fails session start with `composition_asset_missing`; an optional one is a warning. `createAgentSession` accepts `instanceId` (default `default`) and exposes the resolved instance as `session.composition`.
+
+  `revisionHash` (`computeRevisionHash`, `hashAgentFiles`) is the SHA-256 of the normalized manifest, the sorted file entries and the composition entries; it excludes timestamps, host ids, the instance id and connector bindings. `skaile run --dry-run` prints the instance and its revision hash, and `skaile rebuild` now compiles the convention-file items too.
+
+  One section builder fixes the order of an agent's prompt for both the install renderers and the runner (`buildAgentPromptSections`, `@skaile/workspaces/core`): soul → `<MEMORY>` → fragments → constraints → duties → abilities → contracts → composed blocks → prompt-extensions. `<MEMORY>` frames each memory block as `<block name=… scope=…>` capped at its `max_chars`. The system-prompt breakdown (`SystemPromptSection`) gains a `memory` label. `resolveAgentMixins` and `AgentMixinContent` (runner `mixin-resolver`) are removed; their persona / rules / knowledge fields are read through `composes:` and the convention files.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Agent runs have a framework-owned lifecycle. `createRunController({ store, launch, authorize, getInstance, execute, workspaceId, limits? })` (`@skaile/workspaces/runner`) is the authority behind `agent.run` / status / cancel / result / `approval.decide`: `AgentRun` records move `queued -> running -> waiting_approval | waiting_children -> succeeded | failed | cancelled`; delegation depth is capped at 2 and a root run has at most 4 live children (a parent in `waiting_children` holds no driver and resumes with a `children_finished` host message when the last child ends); the runs of one `standing` instance execute one at a time; cancel stops the run and every descendant; `agent.run` is idempotent per `(callerSessionId, callId)`, so a redelivered dispatch answers the same `runId`. Approvals are persisted: a held capability call (or a held start) parks the run, deciding claims the approval with a compare-and-set, executes the stored operation exactly once under its `operationId`, persists the result and resumes the native session with `{ type: "approval_result", operationId, status, result }`. A replay with changed args, a consumed or expired approval, or stored args that no longer match their `argsHash` is `approval_invalid`; an approval a restart cut short is never re-run (`operation_outcome_unknown`). State changes append `AgentRunEvent`s to the store (a host persists them as `agent_run_events` and broadcasts from `onEvent`); `subagent` events carry `runId`. The controller imports no host code: storage is the injected `RunStore` (`createInMemoryRunStore()` ships for `skaile run`, `skaile repl` and tests; Forge brings a durable one), execution the injected `launch`.
+
+  The in-process `agent.run` host that serves `skaile run` / `skaile repl` is now this controller over the in-memory store with a nested-driver launcher; there is no second lifecycle. New types in `@skaile/workspaces/types`: `AgentRun`, `AgentRunEvent`, `AgentRunEventRecord`, `AgentApproval`, `RunStore`, `RunHostMessage`, `AgentRunFilter`, `AgentRunPatch`, `AgentApprovalPatch`.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Protocol 4.16: a session can list and run the workspace's agent instances, and read/write memory blocks and triggers. The runner registers the framework capabilities `agent.list`, `agent.run`, `agent.status`, `agent.cancel`, `agent.result`, `approval.decide`, `memory.read|write|append|list` and `trigger.list|upsert|toggle` from what the host advertises in `session_init.capabilities`: `host.agent_run` switches on `agent.*` + `approval.decide` (host-backed over the existing host-request channel), `host.memory_store` switches on `memory.*`, `host.trigger_store` switches on `trigger.*`. Nothing is registered without the advertisement. A session with no host (`skaile run`, `skaile repl`) serves `agent.list` / `agent.run` in-process: `agent.run` starts a nested driver session of the role instance (`createAgentSession` with that `instanceId`), bounded by the role's `runtime.max_turns`, and its final JSON reply is the run's output; memory and trigger capabilities are absent and `<MEMORY>` renders only the seeded blocks.
+
+  `agent.run` validates `input` against the instance's `io.input` before the run starts (`input_invalid`, nothing started) and the run's `output` against `io.output` after it (`output_invalid`, reported as a failed run). `requiresApproval` follows the instance's `permissions.permission_mode`. New types in `@skaile/workspaces/types`: `AgentRun*`, `AgentInstanceSummary`, `HostAgentRun*`, `HostMemoryStore*`, `HostTriggerStore*`. `SubagentEvent` gains `runId`, `instanceId`, `input`, `runStatus`, `error` and a widened `output`; new events `memory_changed` and `trigger_fired`; `session_init_ack.instances[]` carries each instance's id, ref, lifecycle, revision hash and io summary. `PROTOCOL_VERSION` is 4.16.0. `skaile run` prints `subagent` events of `agent.run` runs.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Agent asset schema `spec_version: "0.2"` (`@skaile/workspaces/types/manifests`). `agent.yaml` gains `lifecycle: standing | role` (default `standing`; a `role` requires an `io: { input, output }` JSON-Schema block), `memory: { blocks[{ name, scope: instance | user | workspace, max_chars, source? }], consolidation? }`, `triggers[]` (discriminated by `kind: schedule | webhook | channel | event`, each with an `id`), and `capabilities[{ name, connector?, required }]`. Memory and triggers are top-level fields only; `memory` / `trigger` are rejected as `composes[].kind`.
+
+  `composes[]` items take an optional slot `id` (`[a-z][a-z0-9_-]*`, required for `connector` and `mcp-server`), `as` and `config`; `kind` stays an open string validated against the kind registry (plus the `soul` pseudo-kind). `kind: agent` items take `binding: delegate | run` (default `delegate`); the new `Binding` values are valid on `agent` items only. New pure helpers `conventionItems()` / `effectiveComposes()` expose `SOUL.md` / `RULES.md` / `DUTIES.md` / `knowledge/` as implicit composition items.
+
+  The deprecated 0.1 inputs (`skills`, `abilities`, `contracts`, `persona`, `rules`, `knowledge`, `requires`, `dependencies`, `metadata.soul` / `orchestrates` / `routes_to` / `knows`) still parse but are no longer read for the catalog: `CatalogEntry.requires` of an agent now lists its `composes[].ref` entries. `agentDeprecationDiagnostics()` returns one named `deprecated_agent_<field>` warning per field, and `skaile validate` prints them. `skaile validate` also reports duplicate slot ids as `composition_conflict`.
+
+  The second, divergent loose `AgentManifest` type in `@skaile/workspaces/core` is removed; `AgentManifest` from `@skaile/workspaces/types/manifests` is the only agent manifest type.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - `skaile install` renders every agent instance of `skaile.yaml` (`agent:` as `default`, plus the `agents:` map) for the target harness, not only the primary agent. Each rendering is named by the instance id: `.claude/agents/<id>.md`, `.omp/agents/<id>/` (its `agent.yaml` carries `composes`, `lifecycle`, `io`, `memory`, `triggers` and `capabilities` verbatim) and `.codex/agents/<id>.toml`. The instance's model, `budget.max_turns` and lifecycle override the asset's. `composes: [{ kind: agent }]` items with binding `delegate` render flat as their own files; `binding: run` items get none.
+
+  Claude frontmatter gains `skills` (composed skills), `mcpServers` (the servers the `mcp-server` slots are bound to through the instance's `connectors` map) and `background: true` for a `role` instance whose agent sets the new `runtime.background`. Codex has no per-tool allowlist, so a tool surface that cannot write or run commands renders `sandbox_mode = "read-only"`.
+
+  Files an earlier install wrote for an instance that has left `skaile.yaml` are removed on the next install, tracked in `.skaile/agent-instances-managed.json`; hand-written agent files are never touched. `skaile install` prints one `agent <id>: <files>` line per instance, and `InstallResult` gains `agentInstances` and `agentFilesRemoved`. `installAgentInstances` is exported from `@skaile/workspaces/asset-manager`.
+
+  The session now forwards the instance id as the native `agentName` (it was `agent.yaml#name`), so a session loads the file its own instance rendered. The Codex driver reads `.codex/skaile-agents/<agentName>.md` instead of the single `.codex/skaile-agent.md`, which would have let two instances overwrite each other.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Asset-kind providers declare where `skaile install` puts them. `IAssetKindProvider.installTarget` (`skill`, `agent`, `prompt`, `flow` or `contract`) replaces the per-kind installer branches and the `NON_DEPLOYABLE_KINDS` list: a kind with a target is copied into the active driver target's directory using the provider's file filter; a kind without one (`connector`, `mcp-server`, `knowledge`, `persona`, `ruleset`, `preset`) is fetched, verified and cached under `.skaile/cache/store/` for composition only. `AiComponent` is now derived from the provider type. `removeAsset` and the asset manager no longer resolve a harness directory for a composition-only kind.
+
+  `persona` and `ruleset` assets are now discoverable and publishable as `PERSONA.md` and `RULESET.md` (provider version 1.1.0). An agent's own `RULES.md` is never a standalone asset.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - The asset-kind provider registry is now the only authority on which asset kinds exist. `createDefaultKindRegistry(extra?)` (`@skaile/workspaces/discovery`) replaces `createDefaultRegistry()`; the CLI builds one registry per process (built-ins plus flow and knowledge) and passes it to the asset manager, catalog sources and `skaile validate`. The static lists are gone: `AssetKindValues`, `AssetKindSchema`, `validateByKind` (types), `ASSET_KINDS`, `INDIVIDUAL_KINDS` (core) and `KNOWN_ASSET_KINDS`, `KnownAssetKind` (library); `AssetKind` is `string`.
+
+  A `SKILL.md` whose `type:` names an unregistered kind (for example `mount`) is no longer silently catalogued as a skill: the scanners skip it and report an `unknown_asset_kind` error diagnostic. `skaile validate` reports `unknown_asset_kind` for an unregistered kind of a manifest file or of an `agent.yaml` `composes:` item. Composition binding resolution throws on an item whose kind has no default binding and no explicit `binding`, instead of falling back to `discoverable`.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - New `skaile migrate agents [paths...]` and `skaile migrate assets [root]` upgrade existing assets mechanically. Both are dry runs by default: they print a unified diff per file and write nothing until `--write`. A migrated `agent.yaml` that would not pass the 0.2 manifest checks is reported and left untouched.
+
+  `migrate agents` rewrites deprecated agent inputs into `composes:` (through the `yaml` Document API, so comments and key order survive) and bumps `spec_version` to `"0.2"`:
+
+  - `skills:` / `abilities:` become `skill` items (`./skills/<name>` when the agent directory ships that skill, otherwise `skill:<name>`); `contracts:` become `contract` items; `knowledge:` becomes `knowledge` items.
+  - `persona:` / `rules:` path refs become `persona` / `ruleset` items with the path kept.
+  - `requires:` / `dependencies:` become `agent` items with `binding: delegate` (a `kind:` prefix on a string picks another kind; `requires[].name` becomes `as`, `requires[].source` the ref). `mcp-server` and `connector` items get a generated slot `id`.
+  - `metadata.orchestrates` becomes items whose kind comes from the `kind:` prefix (usually `skill`); `metadata.routes_to` becomes `agent` items and `metadata.knows` `knowledge` items, for explicit refs only (a `kind:` prefix, a `./`/`../`/`/` path, or `@publisher/name`). Prose entries cannot be resolved and move unchanged to `metadata.routing_notes` / `metadata.knowledge_notes`, so nothing is lost.
+  - `metadata.soul` is dropped when it names `SOUL.md` (the convention file) and becomes a `persona` item otherwise.
+  - A workspace `skaile.yaml` with `agent.subagents.<name>` gets a local role asset `.skaile/agents/<name>/agent.yaml` (`lifecycle: role`, `io` `{task}` → `{result}`; the prompt becomes `SOUL.md`) plus an `agents.<name>: { ref: ./.skaile/agents/<name>, lifecycle: role }` instance. A subagent whose target directory already exists is kept and reported.
+
+  `migrate assets` moves a repo onto the registry-derived kind model:
+
+  - `type: persona` / `type: ruleset` markdown (`_agent-parts/personas/<n>.md`) moves to `<n>/PERSONA.md` / `<n>/RULESET.md` with `type:` dropped, and agent `persona:` / `rules:` refs to the old path become compose items at the new path.
+  - Every `*.bundle.yaml`, and every `kind: bundle` entry of `skaile.yaml#assets`, becomes `<name>.preset.yaml` (`version: 1.0.0`, `items: [{ref: kind:@publisher/name}]`); `bundle:@…` refs in `skaile.yaml#dependencies` become `preset:@…`.
+  - The publication half of `skaile.yaml` (`publisher`, `version`, `assets`) moves into a publisher-only `skaile.manifest.yaml`, written with the same `encodeSkaileManifest` writer `skaile source manifest` uses (publisher normalised to the bare `skaile-ai`); the old `assets:` inventory is dropped (a manifest with `assets:` restricts discovery to the listed assets), the keys are removed from `skaile.yaml`, and a `skaile.yaml` left empty is deleted. An existing `skaile.manifest.yaml` is never overwritten.
+  - Frontmatter `type:` values that name no registered kind (in `SKILL.md` files and under `_agent-parts/`) are reported, never rewritten.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - `preset` is now the only grouping primitive. The `bundle` and `mount` asset kinds are deleted (types, core, library, runner, the capability origin enum). A `preset:@pub/name#ver` entry in `skaile.yaml` `dependencies` expands the preset's asset items (nested presets up to depth 3) into the install set; the lock records only the expanded items. `library://`, placeholder and connector/MCP instance items are skipped and `skaile install` prints `preset <ref>: N assets, M instance items skipped (apply with skaile preset apply)`. Nesting deeper than 3 or a cycle raises `preset_depth_exceeded`; a `bundle:` ref raises `unknown_asset_kind` naming `preset:`. Presets are indexed by `LocalCatalogSource` and kept in curated manifests. `*.bundle.yaml` is replaced by `*.preset.yaml`; `skaile create -k preset` and `skaile add preset:…` replace the bundle forms, and the first-party `workspaces-authoring` bundle is now a preset.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Running an agent now uses the composition bytes that were compiled or pinned, not whatever the sources hold today.
+
+  - New `CompositionContentSource` (`createCompositionContentSource`) resolves a `composes:` ref from a local path, the project lock (a lock pin wins over the catalog; the pinned bytes are hash-verified) or the local catalog scan. Nothing is fetched from the network at session start. A ref that cannot be served exactly as pinned fails with a typed `CompositionError` (`composition_asset_missing`, `composition_conflict`, `composition_rebuild_required`) instead of being skipped.
+  - `compile_manifest.json` is schema 2: each entry also carries `kind`, `resolved_ref` and the captured `content`; hashes are recomputed on read. `inline-snapshot` serves the compiled bytes only (the live-read drift warning is gone); an uncompiled snapshot item is `composition_rebuild_required`. `inline-live` is read once per new run and stored in `.skaile/composition-runs/<session>.json`; a resumed session reuses those bytes. `discoverable` items serve their captured content.
+  - `skaile rebuild` regenerates the manifest from the content source and rejects an agent that composes itself through `kind: agent` items.
+  - `skaile run --agent-definition <ref|path>` selects the agent asset for one single-shot invocation (error when combined with a flow). `skaile run --dry-run "<prompt>"` prints each resolved item (ref, kind, binding, version, hash, source) and how it reaches the claude-code, omp and codex harnesses, without starting a model.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - `skaile.yaml` gains a root `agents:` map of named agent instances (`AgentConfig.instances` in `@skaile/workspaces/core`). Each instance has a `ref`, an optional `lifecycle` (`standing | role`), `model`, `permissions` (same shape as `agent.permissions`), `memory.scope` (`instance | user | workspace | none`), `triggers` (merged by id into the asset's), a `connectors` map from compose slot ids to `connectors[].id`, and a `budget`. `agent:` stays the primary agent and equals `agents.default`; declaring both is an `agent_default_conflict` error. Layers merge instances by id: scalars overlay-win, triggers merge by id, deny lists are unioned. New exports: `AgentInstanceConfig` and friends, `effectiveAgentInstances()`, `mergeAgentInstances()`, `mergeAgentPermissions()`, `normalizeAgentInstances()`, `agentInstanceDiagnostics()`, `resolveAgentDefinitionDir()`.
+
+  `agent.subagents` is removed (the `SubagentConfig` type, the merge, and the `ResolvedSkaileConfig.subagents` session_init field that only forced a session recreate). A `skaile.yaml` that still contains it fails to load with an error pointing to `agents:`.
+
+  `skaile validate` checks every `agents.*.ref` resolves to an `agent.yaml`, role instances have an asset `io`, `connectors` keys are connector slot ids of the asset and values exist in `connectors[]`, and trigger ids are unique per instance and either exist in the asset or are declared in full.
+
+### Patch Changes
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Two fixes for the agent composition migration:
+
+  - `skaile migrate assets` no longer converts the old `skaile.yaml#assets` inventory into the new `skaile.manifest.yaml`. A manifest with an `assets:` list switches discovery into manifest mode where only listed assets exist, which shrank real catalogs (96 skills to 42; agents vanished). The emitted manifest is publisher-only (`publisher`, `version`), the plan prints one line naming how many `assets[]` entries were dropped, and discovery keeps walking the whole tree.
+  - A knowledge dir whose valid `index.yaml` declares `documents: []` is an empty knowledge base, not a missing asset. It compiles (captured with its index bytes), contributes no prompt text or capability and raises no warning or error. A missing dir, or one without a valid index, still fails with `composition_asset_missing`.
+
+- [#1025](https://github.com/skaile-ai/workspaces/pull/1025) [`840afda`](https://github.com/skaile-ai/workspaces/commit/840afda25ba0a8621b69e7254ee988717c2c5bcd) Thanks [@mortegro](https://github.com/mortegro)! - Review fixes for the agent composition release. A run cancelled while its nested role session is being created now ends `cancelled` (the half-started driver is disposed) instead of hanging `agent.run`; `dispose()` waits for nested drivers; finished runs no longer leak approval and call-id entries, and an `agent.run` call id is only replayed for the session that made it. The run ledger behind `agent.status` / `agent.result` survives session rebuilds, so `io.output` is still validated and `finished` is emitted once. `composes[].as` and a composed sub-agent's name must match `[a-z][a-z0-9_-]*` (they name rendered files; `../x` is rejected in the schema and at install, and the instance ledger only removes paths inside the deploy dirs). `SubagentEvent.output` keeps its structured harness shape; the typed output of a role run is `SubagentEvent.result`. A host that declares `host.memory_store` / `host.trigger_store` / `host.agent_run` with `capability_register` instead of `session_init` now gets `memory.*` / `trigger.*` / `agent.*`; `capability_deregister` removes them.
+
 ## 5.5.0
 
 ### Minor Changes

package/dist/app-sdk/index.js

@@ -1,4 +1,4 @@
-import { PROTOCOL_VERSION_STRING } from '../chunk-K2K7OF4P.js';
+import { PROTOCOL_VERSION_STRING } from '../chunk-DMLDYFDS.js';
 import '../chunk-NSBPE2FW.js';
 import * as z from 'zod';
 

package/dist/{asset-feeds-KTFUB7EX.js → asset-feeds-LU7NHOAP.js}

@@ -1,16 +1,27 @@
-import './chunk-3JHFFIQ6.js';
+import { getKnownKinds } from './chunk-OLLAQLFJ.js';
+import './chunk-AOAZCSDI.js';
+import './chunk-QZLWJETK.js';
+import './chunk-NFGRW3L7.js';
+import './chunk-QCI6D7E4.js';
+import './chunk-MX3UQXLU.js';
+import './chunk-XOGG7VDZ.js';
+import './chunk-BTISGSK4.js';
+import './chunk-R7FOF242.js';
+import './chunk-3TXEJN4W.js';
+import './chunk-FRHE7FFB.js';
+import './chunk-TZCQ7ZWQ.js';
 import './chunk-4GY63JU6.js';
-import { factoryAssetRoots } from './chunk-YK7WJSTD.js';
-import './chunk-XGIS325V.js';
+import { factoryAssetRoots } from './chunk-BF33SCLY.js';
+import './chunk-46OVMT76.js';
 import './chunk-5BEFNLOR.js';
 import './chunk-A2ULN3KX.js';
-import { scanRepo } from './chunk-ORUHADS6.js';
+import { scanRepo } from './chunk-2W4LBLIN.js';
 import './chunk-MFHKHXDE.js';
-import './chunk-TOSHZX4C.js';
-import './chunk-SR4RFKHM.js';
+import './chunk-CPSIPIX7.js';
+import './chunk-7ZHLYXTI.js';
 import './chunk-RVRB27AN.js';
-import './chunk-LFMX2UEF.js';
-import './chunk-WX74MVNA.js';
+import './chunk-PA7WLID3.js';
+import './chunk-AO7VJ6G6.js';
 import './chunk-ICSCSM5D.js';
 import './chunk-JMKB7IB4.js';
 import './chunk-MJHSLODD.js';
@@ -23,14 +34,16 @@ import * as path from 'path';
 async function libraryAssets() {
   const notes = [];
   try {
-    const { openLibraryManager, authoringLibraries } = await import('./open-library-Z5NJU4Z5.js');
+    const { openLibraryManager, authoringLibraries } = await import('./open-library-4WUMQHES.js');
     const { manager, close } = await openLibraryManager();
     try {
       const libs = authoringLibraries(await manager.listLibraries());
       const entries = [];
       for (const lib of libs) {
         if (!existsSync(lib.path)) continue;
-        const libEntries = [...await scanRepo(lib.path, lib.name)];
+        const libEntries = [
+          ...await scanRepo(lib.path, lib.name, { knownKinds: getKnownKinds() })
+        ];
         for (const entry of libEntries) entries.push({ origin: "library", entry, group: lib.name });
       }
       return { entries, notes };
@@ -48,7 +61,7 @@ async function libraryAssets() {
 async function storeAssets(projectDir) {
   const notes = [];
   try {
-    const { resolveCatalogSource } = await import('./open-library-Z5NJU4Z5.js');
+    const { resolveCatalogSource } = await import('./open-library-4WUMQHES.js');
     const { source, close } = await resolveCatalogSource({ projectDir });
     try {
       const assets = await source.listAssets();
@@ -97,7 +110,7 @@ async function factoryAssets() {
   try {
     const entries = [];
     for (const root of factoryAssetRoots()) {
-      entries.push(...await scanRepo(root, "skaile-factory"));
+      entries.push(...await scanRepo(root, "skaile-factory", { knownKinds: getKnownKinds() }));
     }
     return { entries, notes };
   } catch (err) {
@@ -127,5 +140,5 @@ async function gatherAssetFeeds(am, projectDir) {
 }
 
 export { gatherAssetFeeds };
-//# sourceMappingURL=asset-feeds-KTFUB7EX.js.map
-//# sourceMappingURL=asset-feeds-KTFUB7EX.js.map
+//# sourceMappingURL=asset-feeds-LU7NHOAP.js.map
+//# sourceMappingURL=asset-feeds-LU7NHOAP.js.map

package/dist/asset-feeds-LU7NHOAP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/src/asset-feeds.ts"],"names":[],"mappings":"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","file":"asset-feeds-LU7NHOAP.js","sourcesContent":["/**\n * asset-feeds.ts — gather installable assets from every feed the manage TUI\n * surfaces.\n *\n * Four feeds, normalized into `CatalogEntry`:\n * - **Project sources** — `skaile.yaml` `sources:` entries (scanned via\n *   `AssetManager.search()`; the new `sources:` field is merged into the\n *   legacy repositories map in `AssetManager.loadConfig`).\n * - **Local libraries** — user authoring places from `LocalIndex` (filesystem\n *   scan of each library's `path`).\n * - **Factory assets** — the bundled first-party `factory-assets` tree\n *   (`factoryAssetRoots()`), scanned from disk. Always present; no network.\n * - **Remote store** — the configured catalog source when `catalog.url` is\n *   not `local`. Failures are non-fatal — they surface as notes.\n */\n\nimport { existsSync } from \"node:fs\";\nimport * as path from \"node:path\";\nimport {\n  type AssetKind,\n  type CatalogEntry,\n  factoryAssetRoots,\n  scanRepo,\n} from \"@skaile/workspaces/core\";\nimport { getKnownKinds } from \"./open-registry.ts\";\n\n/** One non-fatal note returned to the caller for surfacing in the UI. */\nexport interface FeedNote {\n  feed: \"sources\" | \"libraries\" | \"store\" | \"factory\";\n  message: string;\n}\n\n/**\n * Which feed an asset came from. This is the top-level grouping axis in the\n * manage TUI (\"where is this skill coming from?\") and is intentionally distinct\n * from `publisher` (asset-intrinsic identity): the same publisher can legitimately\n * appear under more than one origin (e.g. a github repo you added as a `source`\n * that is also listed in the remote `store`).\n */\nexport type AssetOrigin = \"source\" | \"library\" | \"factory\" | \"store\";\n\n/** A catalog entry tagged with the feed it was gathered from. */\nexport interface OriginEntry {\n  origin: AssetOrigin;\n  entry: CatalogEntry;\n  /**\n   * Second-level grouping label for the manage tree. Defaults (when unset) to the\n   * entry's `publisher`; the source feed sets it to the source's short repo name\n   * so the Sources band groups by source — \"which repo did this come from\" — not\n   * by the asset-intrinsic publisher.\n   */\n  group?: string;\n}\n\nexport interface AssetFeedResult {\n  entries: OriginEntry[];\n  notes: FeedNote[];\n}\n\n/**\n * Pull assets from local libraries (the authoring places under\n * `~/.skaile/libraries/<name>/`, not the `~/.skaile/cache/sources/` cache). Each\n * library's `path` is scanned with `scanRepo` and grouped under the bare library\n * name (`group: <name>`) so the manage TUI shows a clean `<name>` band — no\n * `library:` prefix (mirrors the source feed). Plugin grouping (`entry.plugin`)\n * is stamped by `scanRepo`.\n */\nasync function libraryAssets(): Promise<{\n  entries: OriginEntry[];\n  notes: FeedNote[];\n}> {\n  const notes: FeedNote[] = [];\n  try {\n    const { openLibraryManager, authoringLibraries } = await import(\"./open-library.ts\");\n    const { manager, close } = await openLibraryManager();\n    try {\n      // Authoring libraries are the rows that are NOT source clones.\n      const libs = authoringLibraries(await manager.listLibraries());\n      const entries: OriginEntry[] = [];\n      for (const lib of libs) {\n        if (!existsSync(lib.path)) continue;\n        const libEntries = [\n          ...(await scanRepo(lib.path, lib.name, { knownKinds: getKnownKinds() })),\n        ];\n        for (const entry of libEntries) entries.push({ origin: \"library\", entry, group: lib.name });\n      }\n      return { entries, notes };\n    } finally {\n      close();\n    }\n  } catch (err) {\n    notes.push({\n      feed: \"libraries\",\n      message: err instanceof Error ? err.message : String(err),\n    });\n    return { entries: [], notes };\n  }\n}\n\n/**\n * Pull a (best-effort) snapshot of the connected remote store catalog.\n *\n * - Returns no entries when the resolved catalog is local-only or the host\n *   is unreachable (the failure becomes a note, not an exception).\n * - Maps `CatalogAsset` → `CatalogEntry`, carrying `publisher`, `repo`, and\n *   `category` straight through and using `source = \"store://<id>\"`; per-file\n *   `source` paths are not available for remote assets so the canonical ref is\n *   a stable placeholder.\n */\nasync function storeAssets(projectDir: string): Promise<{\n  entries: CatalogEntry[];\n  notes: FeedNote[];\n}> {\n  const notes: FeedNote[] = [];\n  try {\n    const { resolveCatalogSource } = await import(\"./open-library.ts\");\n    const { source, close } = await resolveCatalogSource({ projectDir });\n    try {\n      const assets = await source.listAssets();\n      const entries: CatalogEntry[] = assets.map((a) => ({\n        name: a.name,\n        kind: (a.kind as AssetKind) ?? \"skill\",\n        description: a.description ?? \"\",\n        source: `store://${a.id}`,\n        publisher: a.publisher,\n        repo: a.repo,\n        plugin: a.plugin,\n        category: a.category,\n        version: a.version,\n        requires: [],\n        dependencies: [],\n      }));\n      return { entries, notes };\n    } finally {\n      close();\n    }\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    // Local-only catalog throws a recognizable message — silence it; absence\n    // is the user's choice, not an error.\n    if (!/local/i.test(msg)) {\n      notes.push({ feed: \"store\", message: msg });\n    }\n    return { entries: [], notes };\n  }\n}\n\n/** The slice of `AssetManager` the source feed needs (kept narrow for tests). */\ninterface AssetManagerLike {\n  search: () => Promise<CatalogEntry[]>;\n  searchRepoRoots: () => { repoName: string; root: string }[];\n}\n\n/**\n * Project-source feed: leans on `AssetManager.search()`, which merges\n * `skaile.yaml`'s `sources:` field into the repositories map. Plugin grouping\n * (`entry.plugin`) is stamped by the scanner, so entries pass through as-is.\n */\nasync function sourceAssets(am: AssetManagerLike): Promise<OriginEntry[]> {\n  // The bundled factory tree is injected into the repositories map as an implicit\n  // source, so `am.search()` returns it too. It has its own `factory` origin band,\n  // so drop it here — otherwise the same first-party skills list twice under Sources.\n  const factoryPrefixes = factoryAssetRoots().map((r) => (r.endsWith(path.sep) ? r : r + path.sep));\n  const isFactoryPath = (p: string) =>\n    factoryPrefixes.some((fp) => p === fp.slice(0, -1) || p.startsWith(fp));\n\n  const all = (await am.search()).filter((e) => !isFactoryPath(e.source));\n  const entries: OriginEntry[] = [];\n  // Group each source's entries under the source node (its short repo name), not\n  // the publisher: under Sources the navigational question is \"which repo did\n  // this come from\". Each entry's `source` (absolute manifest path) lives under\n  // exactly one declared root, so group by prefix. The cache slug is\n  // URL-keyed `github.com/<org>/<repo>` — take the trailing segment.\n  for (const { repoName, root } of am.searchRepoRoots()) {\n    if (isFactoryPath(root)) continue;\n    const prefix = root.endsWith(path.sep) ? root : root + path.sep;\n    const owned = all.filter((e) => e.source === root || e.source.startsWith(prefix));\n    if (owned.length === 0) continue;\n    const sourceName = repoName.split(\"/\").pop() || repoName;\n    for (const entry of owned) entries.push({ origin: \"source\", entry, group: sourceName });\n  }\n  return entries;\n}\n\n/**\n * Factory-asset feed: scan the bundled first-party `factory-assets` tree(s)\n * resolved by `factoryAssetRoots()` (the `SKAILE_FACTORY_ASSETS_DIR` override\n * layer ahead of the bundled tree). Local disk only, no network — the entries are\n * the built-in skills / connectors / bundles that ship with `@skaile/workspaces`.\n * `factoryAssetRoots()` already dedupes, so the env override pointing at the\n * bundled dir collapses to one root.\n */\nasync function factoryAssets(): Promise<{\n  entries: CatalogEntry[];\n  notes: FeedNote[];\n}> {\n  const notes: FeedNote[] = [];\n  try {\n    const entries: CatalogEntry[] = [];\n    for (const root of factoryAssetRoots()) {\n      entries.push(...(await scanRepo(root, \"skaile-factory\", { knownKinds: getKnownKinds() })));\n    }\n    return { entries, notes };\n  } catch (err) {\n    notes.push({\n      feed: \"factory\",\n      message: err instanceof Error ? err.message : String(err),\n    });\n    return { entries: [], notes };\n  }\n}\n\n/** Tag a flat entry list with a single origin. */\nfunction tag(origin: AssetOrigin, entries: CatalogEntry[]): OriginEntry[] {\n  return entries.map((entry) => ({ origin, entry }));\n}\n\n/**\n * Run all feeds and return a single normalized result.\n *\n * Feeds run in parallel where possible — the store fetch is the slow one\n * (one HTTP call) and is fired alongside the local library walk. The factory\n * scan is local disk only, so it runs inline.\n */\nexport async function gatherAssetFeeds(\n  am: AssetManagerLike,\n  projectDir: string,\n): Promise<AssetFeedResult> {\n  const [libs, store] = await Promise.all([libraryAssets(), storeAssets(projectDir)]);\n  const factory = await factoryAssets();\n  const src = await sourceAssets(am);\n  return {\n    entries: [\n      ...src,\n      ...libs.entries,\n      ...tag(\"factory\", factory.entries),\n      ...tag(\"store\", store.entries),\n    ],\n    notes: [...libs.notes, ...store.notes, ...factory.notes],\n  };\n}\n"]}

package/dist/asset-manager/catalog-deployer.js

@@ -1,17 +1,17 @@
-export { WORKSPACE_MOUNT_ENV_VAR, deployAll, deployCatalogEntry, findAiAssetsRoot, isUnderWorkspaceMount, resolveFlowSkills, undeployCatalogEntry, workspaceMountDirs } from '../chunk-JKWU6ULI.js';
-import '../chunk-3JHFFIQ6.js';
+export { WORKSPACE_MOUNT_ENV_VAR, deployAll, deployCatalogEntry, findAiAssetsRoot, isUnderWorkspaceMount, resolveFlowSkills, undeployCatalogEntry, workspaceMountDirs } from '../chunk-SDFROXSA.js';
+import '../chunk-TZCQ7ZWQ.js';
 import '../chunk-4GY63JU6.js';
-import '../chunk-YK7WJSTD.js';
-import '../chunk-XGIS325V.js';
+import '../chunk-BF33SCLY.js';
+import '../chunk-46OVMT76.js';
 import '../chunk-5BEFNLOR.js';
 import '../chunk-A2ULN3KX.js';
-import '../chunk-ORUHADS6.js';
+import '../chunk-2W4LBLIN.js';
 import '../chunk-MFHKHXDE.js';
-import '../chunk-TOSHZX4C.js';
-import '../chunk-SR4RFKHM.js';
+import '../chunk-CPSIPIX7.js';
+import '../chunk-7ZHLYXTI.js';
 import '../chunk-RVRB27AN.js';
-import '../chunk-LFMX2UEF.js';
-import '../chunk-WX74MVNA.js';
+import '../chunk-PA7WLID3.js';
+import '../chunk-AO7VJ6G6.js';
 import '../chunk-ICSCSM5D.js';
 import '../chunk-JMKB7IB4.js';
 import '../chunk-MJHSLODD.js';

package/dist/asset-manager/index.js

@@ -1,33 +1,33 @@
-export { AssetManager, FACTORY_SOURCE_URL, MissingManifestError, NON_DEPLOYABLE_KINDS, normalizeRepoUrl, parseCanonicalLockKey, parseRefTolerant, renderMcpServerConfig, softDepName } from '../chunk-MMC24L2W.js';
-import '../chunk-AC2N5BRP.js';
-import '../chunk-Y7UBRRKG.js';
-import '../chunk-VKSA2CDJ.js';
+export { AssetManager, FACTORY_SOURCE_URL, MissingManifestError, installAgentInstances, normalizeRepoUrl, parseCanonicalLockKey, parseRefTolerant, renderMcpServerConfig, softDepName } from '../chunk-PTO2YDDG.js';
+import '../chunk-MX3UQXLU.js';
+import '../chunk-XOGG7VDZ.js';
+import '../chunk-BTISGSK4.js';
 import '../chunk-R7FOF242.js';
-import '../chunk-ZDKJHQY2.js';
-export { createScaffold, deployAll, installAgent, removeAsset } from '../chunk-75EX5GY4.js';
+import '../chunk-3TXEJN4W.js';
+export { createScaffold, deployAll, installAgent, installTargetOf, removeAsset } from '../chunk-2KOKBTR4.js';
 export { BUILT_IN_FRAGMENTS, loadPromptExtensions, resolveFragments } from '../chunk-CGYEHQOX.js';
-import '../chunk-3JHFFIQ6.js';
+export { appendHistory, clearHistory, getRecentHistory, loadHistory } from '../chunk-KTBKW2FI.js';
+import '../chunk-UQ6LFBPZ.js';
+export { AGENT_RENDERERS, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, renderAgentToFramework } from '../chunk-VKSXST23.js';
+import '../chunk-FRHE7FFB.js';
+import '../chunk-TZCQ7ZWQ.js';
 import '../chunk-4GY63JU6.js';
-import '../chunk-YK7WJSTD.js';
-import '../chunk-XGIS325V.js';
+import '../chunk-BF33SCLY.js';
+import '../chunk-46OVMT76.js';
 import '../chunk-5BEFNLOR.js';
 import '../chunk-A2ULN3KX.js';
-import '../chunk-ORUHADS6.js';
+import '../chunk-2W4LBLIN.js';
 import '../chunk-MFHKHXDE.js';
-import '../chunk-TOSHZX4C.js';
-import '../chunk-SR4RFKHM.js';
+import '../chunk-CPSIPIX7.js';
+import '../chunk-7ZHLYXTI.js';
 import '../chunk-RVRB27AN.js';
-import '../chunk-LFMX2UEF.js';
-import '../chunk-WX74MVNA.js';
+import '../chunk-PA7WLID3.js';
+import '../chunk-AO7VJ6G6.js';
 import '../chunk-ICSCSM5D.js';
 import '../chunk-JMKB7IB4.js';
 import '../chunk-MJHSLODD.js';
 import '../chunk-C3CAXQMA.js';
 import '../chunk-BOFL7GIF.js';
-export { appendHistory, clearHistory, getRecentHistory, loadHistory } from '../chunk-KTBKW2FI.js';
-import '../chunk-UQ6LFBPZ.js';
-export { AGENT_RENDERERS, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, renderAgentToFramework } from '../chunk-TNWXGHLD.js';
-import '../chunk-5CYEWBPB.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/asset-manager/installer.js

@@ -1,25 +1,25 @@
-export { canonicalEntryRef, createScaffold, deployAll, deployAsset, removeAsset } from '../chunk-75EX5GY4.js';
+export { canonicalEntryRef, createScaffold, deployAll, deployAsset, installTargetOf, removeAsset } from '../chunk-2KOKBTR4.js';
 import '../chunk-CGYEHQOX.js';
-import '../chunk-3JHFFIQ6.js';
+import '../chunk-VKSXST23.js';
+import '../chunk-FRHE7FFB.js';
+import '../chunk-TZCQ7ZWQ.js';
 import '../chunk-4GY63JU6.js';
-import '../chunk-YK7WJSTD.js';
-import '../chunk-XGIS325V.js';
+import '../chunk-BF33SCLY.js';
+import '../chunk-46OVMT76.js';
 import '../chunk-5BEFNLOR.js';
 import '../chunk-A2ULN3KX.js';
-import '../chunk-ORUHADS6.js';
+import '../chunk-2W4LBLIN.js';
 import '../chunk-MFHKHXDE.js';
-import '../chunk-TOSHZX4C.js';
-import '../chunk-SR4RFKHM.js';
+import '../chunk-CPSIPIX7.js';
+import '../chunk-7ZHLYXTI.js';
 import '../chunk-RVRB27AN.js';
-import '../chunk-LFMX2UEF.js';
-import '../chunk-WX74MVNA.js';
+import '../chunk-PA7WLID3.js';
+import '../chunk-AO7VJ6G6.js';
 import '../chunk-ICSCSM5D.js';
 import '../chunk-JMKB7IB4.js';
 import '../chunk-MJHSLODD.js';
 import '../chunk-C3CAXQMA.js';
 import '../chunk-BOFL7GIF.js';
-import '../chunk-TNWXGHLD.js';
-import '../chunk-5CYEWBPB.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=installer.js.map
 //# sourceMappingURL=installer.js.map

package/dist/asset-manager/renderers.js

@@ -1,5 +1,23 @@
-export { AGENT_RENDERERS, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, renderAgentToFramework } from '../chunk-TNWXGHLD.js';
-import '../chunk-5CYEWBPB.js';
+export { AGENT_RENDERERS, CODEX_IDENTITY_DIR, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, renderAgentToFramework } from '../chunk-VKSXST23.js';
+import '../chunk-FRHE7FFB.js';
+import '../chunk-TZCQ7ZWQ.js';
+import '../chunk-4GY63JU6.js';
+import '../chunk-BF33SCLY.js';
+import '../chunk-46OVMT76.js';
+import '../chunk-5BEFNLOR.js';
+import '../chunk-A2ULN3KX.js';
+import '../chunk-2W4LBLIN.js';
+import '../chunk-MFHKHXDE.js';
+import '../chunk-CPSIPIX7.js';
+import '../chunk-7ZHLYXTI.js';
+import '../chunk-RVRB27AN.js';
+import '../chunk-PA7WLID3.js';
+import '../chunk-AO7VJ6G6.js';
+import '../chunk-ICSCSM5D.js';
+import '../chunk-JMKB7IB4.js';
+import '../chunk-MJHSLODD.js';
+import '../chunk-C3CAXQMA.js';
+import '../chunk-BOFL7GIF.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=renderers.js.map
 //# sourceMappingURL=renderers.js.map

package/dist/asset-manager/src/index.d.ts

@@ -10,8 +10,11 @@
  *   await am.install()
  */
 import type { AssetRef, CatalogEntry, DriverTarget, LockFile, StoreFetcher } from "@skaile/workspaces/core";
+import type { IAssetKindRegistry } from "@skaile/workspaces/plugins";
+import type { PresetExpansion } from "@skaile/workspaces/core";
 import type { AssetFetcher } from "@skaile/workspaces/library";
 import type { HistoryEntry } from "./history.js";
+import { type InstalledAgentInstance } from "./install-instances.js";
 import type { ScaffoldOptions } from "./installer.js";
 /**
  * Normalize a git remote URL to a comparable identity so the same repo declared
@@ -20,15 +23,6 @@ import type { ScaffoldOptions } from "./installer.js";
  * explicit user declaration.
  */
 export declare function normalizeRepoUrl(url: string): string;
-/**
- * Asset kinds that are never **copied into a driver target dir** as files —
- * bundles resolve to their members, mcp-servers are wired at session startup,
- * and the mixin kinds are resolved at session creation. Mirrors the skip set in
- * `deployAll`, and says nothing about whether store bytes are fetched:
- * `mcp-server` IS staged into the store cache (see `stageStoreAssets`), because
- * its wiring reads a real `MCP.md` off disk.
- */
-export declare const NON_DEPLOYABLE_KINDS: Set<string>;
 /**
  * Parse a canonical lock key (`<kind>:@<publisher>/<name>#<version>`) into its
  * parts. The lock key is a canonical asset ref, so this delegates to the one ref
@@ -141,7 +135,8 @@ export declare class MissingManifestError extends Error {
 export type { HistoryEntry } from "./history.js";
 export { appendHistory, clearHistory, getRecentHistory, loadHistory, } from "./history.js";
 export type { DeployOptions, ScaffoldOptions } from "./installer.js";
-export { createScaffold, deployAll, removeAsset } from "./installer.js";
+export type { DeployableEntry } from "./installer.js";
+export { createScaffold, deployAll, installTargetOf, removeAsset } from "./installer.js";
 export type { RenderMcpConfigOptions, RenderMcpConfigResult, SkippedMcpServer, } from "./mcp-config.js";
 export { renderMcpServerConfig } from "./mcp-config.js";
 export type { Log } from "./renderers.js";
@@ -207,6 +202,24 @@ export interface InstallResult {
      * Non-fatal — listed for telemetry and CLI reporting.
      */
     npmFailed?: string[];
+    /**
+     * One entry per `preset:` dependency expanded into this install (nested presets
+     * included): how many asset items joined the install set and how many instance
+     * items (`library://`, placeholders) were skipped.
+     */
+    presets?: PresetExpansion[];
+    /**
+     * One entry per `skaile.yaml` agent instance (`agent:` as `default`, plus
+     * `agents:`) rendered into the target harness's native agent files, with the
+     * workspace-relative paths written. Absent for `--global` installs and
+     * harnesses without a native agent format.
+     */
+    agentInstances?: InstalledAgentInstance[];
+    /**
+     * Workspace-relative native agent files removed because their instance left
+     * `skaile.yaml` (only files an earlier `skaile install` rendered are ever removed).
+     */
+    agentFilesRemoved?: string[];
 }
 /**
  * An installed asset whose source repository is behind the remote.
@@ -329,6 +342,11 @@ export interface OverviewResult {
 export interface AssetManagerOptions {
     /** Absolute or relative path to the workspace root (must contain `skaile.yaml`). */
     projectDir: string;
+    /**
+     * The process's asset-kind registry — the only authority on which kinds exist.
+     * Typed frontmatter whose `type:` is not registered is reported, not catalogued.
+     */
+    registry: IAssetKindRegistry;
     /**
      * Agent framework to target for asset deployment.
      * Determines which framework directories (``.claude/``, ``.omp/``, etc.) are used.
@@ -423,6 +441,9 @@ export declare class AssetManager {
     readonly driverTarget: DriverTarget;
     /** Whether this instance operates in global-install mode. */
     readonly global: boolean;
+    /** Asset-kind registry shared with the host (one instance per process). */
+    readonly registry: IAssetKindRegistry;
+    private _knownKinds?;
     /** Explicit global-harness override (global mode only); else auto-resolved. */
     private readonly harnessesOverride?;
     /** Injected catalog fetcher (tests / custom); falls back to a built one. */
@@ -436,6 +457,14 @@ export declare class AssetManager {
     /** Sink for cross-library collision warnings; else `console.warn`. */
     private readonly onLibraryCollision?;
     constructor(opts: AssetManagerOptions);
+    /** Registered kind names — the `knownKinds` argument of the manifest scanners. */
+    private get knownKinds();
+    /**
+     * The harness component dir a kind installs into (its provider's
+     * `installTarget`), or `undefined` for composition-only kinds, which are only
+     * cached in the store cache and composed at session start.
+     */
+    private installTarget;
     /**
      * Root for this manager's **state** — config SSOT, lock, cache, history.
      * `~/.skaile` in global mode (the cross-harness SSOT), else the project dir.
@@ -476,6 +505,14 @@ export declare class AssetManager {
      * swallowed.
      */
     private renderDriverMcpConfig;
+    /**
+     * Render every agent instance of `skaile.yaml` into the driver target's native
+     * agent files (`.claude/agents/<id>.md`, …) and prune the renderings of
+     * instances that left the config. Runs after the skills deploy, so composed
+     * skills resolve. Project scope only. Never fails an install — a render error
+     * is warned and swallowed.
+     */
+    private renderAgentInstances;
     private loadConfig;
     /** Build provenance-index clones from the resolved source declarations. */
     private buildClones;
@@ -567,7 +604,7 @@ export declare class AssetManager {
      * Fetch + SHA-verify the bytes of every store-resolved candidate that needs
      * bytes on disk into `.skaile/cache/store/`, reusing the same verified-fetch
      * path the pointer-only `library.install` uses (`installFromManifest` flat
-     * mode). That is the deployable kinds plus `mcp-server` — see the skip guard.
+     * mode). Every kind with bytes, composition-only kinds included.
      *
      * @returns Map of candidate key → staged primary-manifest path.
      */
@@ -697,20 +734,20 @@ export declare class AssetManager {
         toRef?: string;
     }>>;
     /**
-     * Bundles in the configured sources (and the bundled factory source) that list
-     * `ref` as a member, for the `skaile add` discoverability hint. Membership is
-     * not a dependency: nothing here installs the bundle or its siblings.
+     * Presets in the configured sources (and the bundled factory source) that list
+     * `ref` as an asset item, for the `skaile add` discoverability hint. Membership is
+     * not a dependency: nothing here installs the preset or its siblings.
      *
      * Matches on kind + name, and on publisher only when both sides carry one, so
-     * a bare `skill:x` member line still matches `skill:@pub/x`. Bundles already
+     * a bare `skill:x` item still matches `skill:@pub/x`. Presets already
      * declared in `skaile.yaml` are left out. Best-effort: any failure yields `[]`,
      * so it can never fail an `add` that succeeded.
      *
      * @param ref - The added asset ref (`kind:name`, `kind:@pub/name`, optionally pinned).
-     * @returns One `{ name, ref }` per containing bundle, deduped by `ref`; `ref` is
-     *   the `skaile add` form (`bundle:@pub/name`, or `bundle:name` without a publisher).
+     * @returns One `{ name, ref }` per containing preset, deduped by `ref`; `ref` is
+     *   the `skaile add` form (`preset:@pub/name`, or `preset:name` without a publisher).
      */
-    bundlesContaining(ref: string): Promise<Array<{
+    presetsContaining(ref: string): Promise<Array<{
         name: string;
         ref: string;
     }>>;
@@ -789,6 +826,8 @@ export declare class AssetManager {
      *
      * @param ref - Asset ref in `kind:name` form (e.g. `skill:my-skill`).
      * @returns `true` if the asset was found and removed, `false` if it was not deployed.
+     *   A `preset:` ref has no deployed files: it is found when declared in `skaile.yaml`, and
+     *   only its declaration goes — its expanded items leave with the next `skaile install`.
      */
     remove(ref: string): boolean;
     /**
@@ -857,11 +896,12 @@ export declare class AssetManager {
      * with a reconciliation {@link DeclaredState}:
      *
      * - `declared` — in `skaile.yaml`, not yet resolved into the lock.
-     * - `installed` — declared + locked, and (for deployable kinds) materialized on
-     *   disk. An `mcp-server` is instead checked against the declarations the runner
-     *   would actually wire (store-staged or materialized `MCP.md`); the remaining
-     *   non-deployable kinds ({@link NON_DEPLOYABLE_KINDS}) count as installed once
-     *   locked — they are resolved at session start with no on-disk footprint here.
+     * - `installed` — declared + locked, and (for kinds with an `installTarget`)
+     *   materialized on disk. An `mcp-server` is instead checked against the
+     *   declarations the runner would actually wire (store-staged or materialized
+     *   `MCP.md`); the remaining composition-only kinds (no `installTarget`) count as
+     *   installed once locked — they are resolved at session start with no harness
+     *   footprint here.
      * - `drift` — declared + locked but the deployed files are missing on disk.
      * - `invalid` — the `dependencies:` entry isn't a parseable canonical ref. Only
      *   surfaced in the unfiltered listing (a `kind` filter can't classify it).
@@ -1015,7 +1055,7 @@ export declare class AssetManager {
      * Create a minimal asset scaffold directory (delegates to {@link createScaffold}).
      *
      * @param name - Asset name (also used as the directory name).
-     * @param kind - Asset kind: `skill` | `agent` | `bundle` | `flow` | `prompt` | `contract`.
+     * @param kind - Asset kind: `skill` | `agent` | `preset` | `flow` | `prompt` | `contract`.
      * @param destDir - Parent directory to create the asset in.
      * @param opts - Optional scaffold content (`description`).
      * @returns `{ ok: true, path }` on success, `{ ok: false, path: errorMessage }` if the
@@ -1085,6 +1125,8 @@ export declare class AssetManager {
     private resolveRepoDir;
 }
 export { installAgent } from "./install-agent.js";
+export type { InstalledAgentInstance, InstallAgentInstancesOptions, InstallAgentInstancesResult, } from "./install-instances.js";
+export { installAgentInstances } from "./install-instances.js";
 export type { AgentRenderer, AgentRenderInput, AgentRenderResult } from "./renderers.js";
 export { AGENT_RENDERERS, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, } from "./renderers.js";
 export type { AbilityRef, ConnectorRef, ContractRef, FragmentContext, FragmentId, } from "./fragments.js";