@skaile/workspaces 6.14.0 → 6.16.0

package/dist/asset-manager/src/shared/refs.d.ts

@@ -0,0 +1,101 @@
+import { type AssetRef, type CatalogEntry, type LockFile, type PresetExpansion } from "@skaile/workspaces/core";
+import type { MemberIdentity } from "./types.js";
+/**
+ * Drop a publisher scope so a declared `@pub/name` compares equal to an on-disk
+ * / declared `name` (both directions are checked at the call sites).
+ */
+export declare function unscopedName(x: string): string;
+/**
+ * Qualify a dependency ref with `fallback` (the declaring asset's publisher) when it
+ * names none: `name` / `kind:name[#pin]` become `kind:@fallback/name[#pin]`. A ref
+ * that already carries a scope is returned unchanged. Same rule `resolveAll` applies
+ * to a source/store candidate's transitive deps.
+ */
+export declare function qualifyDepRef(ref: string, fallback: string): string;
+/**
+ * The canonical refs among `deployed` whose library asset body is still the untouched
+ * `library create` scaffold (the check `validate` and the publish plan fail, p926). An entry whose
+ * file cannot be read, or that has no markdown body, is never reported.
+ */
+export declare function scaffoldBodyRefs(entries: readonly CatalogEntry[], deployed: readonly string[]): string[];
+/**
+ * The canonical refs among `deployed` whose library asset `description:` is still the untouched
+ * `library create` placeholder (the check `validate` and the publish plan fail, p926).
+ */
+export declare function scaffoldDescriptionRefs(entries: readonly CatalogEntry[], deployed: readonly string[]): string[];
+/**
+ * Every dependency a library asset declares, as publisher-qualified refs: bundle
+ * `dependencies` (raw refs) plus `requires` (as parsed by `parseRequires`, which also
+ * carries a manifest entry's `dependencies`). A dependency without a publisher inherits
+ * the declaring asset's (same-library assumption); `@publisher/name` ones keep theirs.
+ */
+export declare function libraryEntryDepRefs(e: CatalogEntry): string[];
+/**
+ * Why the flow engine rejects the flow file of `e` (the parse `loadFlow` runs): its first
+ * complaints as one phrase, or `undefined` when it loads. A file that cannot be read is left
+ * to the deploy, which names it. `e.source` is the flow file or the folder holding
+ * `<name>.flow.yaml`.
+ */
+export declare function flowLoadError(e: Pick<CatalogEntry, "name" | "source">): string | undefined;
+/**
+ * Refuse a `flow` entry whose file the flow engine rejects, before anything is written. `add`,
+ * `install`, `install --locked` and `update` all stop here, with the sentence `check` and
+ * `doctor` use for the deployed copy (p1192).
+ *
+ * @param done - What did not happen, e.g. `added` or `installed`.
+ * @throws One line naming the flow and the engine's first complaints.
+ */
+export declare function assertFlowsLoad(entries: readonly CatalogEntry[], done: "added" | "installed"): void;
+/** `<publisher>/<kind>:<name>` identity of a publisher-qualified ref; `null` when unparseable or unqualified. */
+export declare function refIdentity(ref: string): string | null;
+/**
+ * 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
+ * parser; `AssetRef.pin` is exposed as `version` so the callers' destructuring is
+ * unchanged. Stays total — callers rely on `{}`-then-`continue`, but `parseAssetRef`
+ * throws, so a genuinely malformed key is caught and returned as `{}`.
+ *
+ * A **content-sha pseudo-version** key (`#0.0.0-sha.<hash>`, the version every
+ * manifest-less source gets) fails `parseAssetRef`'s canonical-pin check. Dropping
+ * it to `{}` would strip the identity, so the install reconcile / state machine
+ * could never act on such an asset (it silently survives a remove-from-yaml). Fall
+ * back to parsing the bare identity, keeping the raw pin as `version`.
+ *
+ * @internal Exported for unit tests; not part of the stable public surface.
+ */
+export declare function parseCanonicalLockKey(key: string): {
+    publisher?: string;
+    kind?: string;
+    name?: string;
+    version?: string;
+};
+/**
+ * Parse a ref for lookup, tolerating a **missing publisher** (`kind:name`, the
+ * shape `listDeployed` emits and the strict `parseAssetRef` rejects). Returns
+ * `null` when neither kind nor name is recoverable. Unlike {@link parseAssetRefLoose}
+ * (publisher-required, only strips a `#pin`), this keeps the publisher optional.
+ *
+ * @internal Exported for unit tests; not part of the stable public surface.
+ */
+export declare function parseRefTolerant(ref: string): AssetRef | null;
+/** The `presets` slice of a lock built for `presets`: canonical refs, one per preset, sorted; empty when none. */
+export declare function presetsLockSlice(presets: readonly PresetExpansion[]): Pick<LockFile, "presets">;
+/** The fix for a source clone folder that holds no usable git checkout. */
+export declare const RUN_SOURCE_SYNC = "run `skaile source sync` to clone it again";
+/** The first half of every "nothing holds it" fix: register the library that holds the ref. */
+export declare const REGISTER_HOLDER = "register the library that holds it with `skaile library init <name> --path <dir>`";
+/** Whether `ref` names the asset `want` does: same kind and name, same publisher when both carry one. */
+export declare function sameAsset(ref: string, want: {
+    kind: string;
+    name: string;
+    publisher?: string;
+}): boolean;
+/** `kind:name` of a {@link LockGap} ref, publisher and pin left out; the raw ref when it does not parse. */
+export declare function gapIdentity(ref: string): string;
+/**
+ * Version-agnostic `{ kind, name, publisher? }` of a member ref as a preset may
+ * write it: canonical `kind:@pub/name`, bare `kind:name`, or the legacy
+ * `kind:name@pub`, each optionally `#pinned`. Publisher is bare (no `@`).
+ */
+export declare function memberIdentity(ref: string): MemberIdentity | null;
+//# sourceMappingURL=refs.d.ts.map

package/dist/asset-manager/src/shared/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../asset-manager/src/shared/refs.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,EAAE,CAcV;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,EAAE,CAOV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAW7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,GAAG,SAAS,CAuB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,IAAI,EAAE,OAAO,GAAG,WAAW,GAC1B,IAAI,CASN;AAED,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAqBA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAc7D;AAED,kHAAkH;AAClH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAG/F;AAED,2EAA2E;AAC3E,eAAO,MAAM,eAAe,+CAA+C,CAAC;AAE5E,+FAA+F;AAC/F,eAAO,MAAM,eAAe,sFACyD,CAAC;AAEtF,yGAAyG;AACzG,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAQT;AAED,4GAA4G;AAC5G,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgBjE"}

package/dist/asset-manager/src/shared/types.d.ts

@@ -0,0 +1,399 @@
+import type { CatalogEntry, HarnessName, LockEntry, LockFile, PresetExpansion, ProvenanceCandidate } from "@skaile/workspaces/core";
+import type { AssetDefinition, Library } from "@skaile/workspaces/library";
+import type { InstalledAgentInstance } from "../install-instances.js";
+import type { DeployableEntry } from "../installer.js";
+import type { HarnessDeclaredAsset } from "../read/state.js";
+/**
+ * Snapshot of the local index's library side: the registered libraries and every
+ * indexed asset definition. Library assets are bytes on disk; the index is the
+ * authority on their *version* (a `skaile.manifest.yaml` `assets[].version` can
+ * differ from the asset's own frontmatter) and content hash.
+ */
+export interface LibraryIndexSnapshot {
+    libraries: Library[];
+    defs: AssetDefinition[];
+}
+/** Kind, name and bare publisher of an asset, as far as known; compared for deploy-folder clashes. */
+export interface FolderIdentity {
+    kind?: string;
+    name?: string;
+    publisher?: string;
+}
+/** What `update` knows about the locked libraries, so an equal-version tie keeps the locked source. */
+export interface PreferLocked {
+    /** `kind:publisher/name` → the library name its lock entry resolves to here ({@link AssetManager.lockedLibraryNames}). */
+    libraries: ReadonlyMap<string, string | null>;
+    /** `kind:publisher/name` → the sha256 the lock recorded for the library copy. */
+    shas: ReadonlyMap<string, string>;
+}
+/** Library leg of a resolution: matched deploy entries, the refs they cover, and their library. */
+export interface LibraryResolution {
+    entries: DeployableEntry[];
+    resolved: Set<string>;
+    libraryOf: Map<CatalogEntry, string>;
+}
+/**
+ * Lock entries a declared ref that no longer resolves keeps: every lock entry of the same
+ * kind + name (and publisher, when the ref names one), so `install` neither deletes the
+ * deployed files nor drops the pin, plus the `sources[]` rows those entries point at.
+ * `refs` are the missed refs that matched an entry.
+ */
+export interface KeptLockEntries {
+    assets: Record<string, LockEntry>;
+    sources: LockFile["sources"];
+    refs: Set<string>;
+    /** The lock keys each kept ref matched. */
+    keysByRef: Map<string, string[]>;
+}
+/** A locked asset that now resolves from another library than its lock entry named. */
+export interface LibraryMove {
+    /** `kind:@publisher/name` (no version). */
+    ref: string;
+    /** Library name the lock entry recorded. */
+    from: string;
+    /** Library name the asset resolved from now. */
+    to: string;
+}
+/**
+ * A locked library asset `install` keeps in place of a library edit, with what it requires.
+ * `contentChanged`: the library holds the locked version with other bytes (an edit with no bump).
+ */
+export interface KeptLibraryEntry {
+    key: string;
+    entry: LockEntry;
+    requires: string[];
+    contentChanged: boolean;
+}
+/** A locked library asset whose library holds the locked version with other bytes (an edit with no bump). */
+export interface ContentHeld {
+    /** The lock key, `kind:@publisher/name#version`. */
+    ref: string;
+    /** The library that holds the changed files. */
+    library: string;
+    version: string;
+}
+/** What {@link AssetManager.resolveLibraryFirst} resolved: candidates, still-missing refs, library entries, presets. */
+export interface LibraryFirstResolution {
+    resolved: ProvenanceCandidate[];
+    missing: string[];
+    overridesApplied: Set<string>;
+    lib: LibraryResolution;
+    presets: PresetExpansion[];
+    requiredBy: Map<string, string[]>;
+    /** Lock entries of library assets the library holds at another version than locked: `install` keeps them (only `update` moves a lock). */
+    keptVersions: Record<string, LockEntry>;
+    /** One `ref (reason)` line for each such asset whose deployed copy is gone: the locked version cannot be restored from the newer files. */
+    versionBlocked: string[];
+    /** Locked library assets the library holds at the locked version with other bytes: `install` keeps them, only `update` takes the edit. */
+    contentHeld: ContentHeld[];
+    /** The library presets met on the way (a preset is never deployed, so it is not in `lib.entries`): `add` runs the manifest and file checks on them too. */
+    libraryPresets: Array<{
+        entry: CatalogEntry;
+        library: string;
+    }>;
+}
+/**
+ * How a library named in a lock entry stands on this machine: usable at `path`, registered but
+ * with its directory gone, or not registered at all (renamed away, removed, or never registered
+ * here). One result for {@link AssetManager.lockedLibrary}, the only place that decides it.
+ * `name` of an `ok` lookup is the name the library is registered under here, which is not the
+ * locked name when the lock's remote URL matched another registered library.
+ */
+export type LockedLibrary = 
+/**
+ * `matched: "content"` - the locked name is gone and the library was found by the asset it
+ * holds (same publisher and name, the locked content hash), not by name or remote URL.
+ * `matched: "id"` - the lock names the library by its stable id; `name` is the name it has now.
+ * `matched: "url"` - the locked name is gone and another registered library has the locked remote.
+ */
+{
+    state: "ok";
+    path: string;
+    name: string;
+    matched?: "content" | "id" | "url";
+} | {
+    state: "dir-missing";
+    path: string;
+    name?: string;
+} | {
+    state: "unregistered";
+};
+/** Version-agnostic identity of a member ref (see {@link memberIdentity}). */
+export interface MemberIdentity {
+    kind: string;
+    name: string;
+    publisher?: string;
+}
+/**
+ * Reconciliation state of a declared dependency relative to the lock + disk.
+ * `invalid` flags a `dependencies:` entry that isn't a parseable canonical ref —
+ * surfaced (not silently dropped) so a `skaile.yaml` typo is visible.
+ */
+export type DeclaredState = "declared" | "installed" | "drift" | "invalid" | "skipped";
+/**
+ * A top-level dependency declared in `skaile.yaml`, annotated with its
+ * reconciliation {@link DeclaredState}. Transitive (lock-only) deps are never
+ * included — {@link AssetManager.listDeclared} walks the declared set only.
+ */
+export interface DeclaredAsset {
+    /** The canonical declared ref exactly as written in `skaile.yaml`. */
+    ref: string;
+    kind: string;
+    name: string;
+    state: DeclaredState;
+    /** Set with `skipped`: why skaile does not write the `mcp-server` to the coding agent's MCP config. */
+    reason?: string;
+}
+/** A deployed library asset that lacks files of its library entry. See {@link AssetManager.incompleteDeploys}. */
+export interface IncompleteDeploy {
+    /** Canonical ref of the asset. */
+    ref: string;
+    /** Files the deploy writes that are absent from the deployed directory, relative to it. */
+    missing: string[];
+}
+/** @deprecated Use {@link HarnessDeclaredAsset}; the `backend` field is now `harness`. Removed in the next major. */
+export type BackendDeclaredAsset = HarnessDeclaredAsset;
+/**
+ * Metadata about a repository declared in `skaile.yaml`.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface RepoInfo {
+    /** Repository name as declared in `skaile.yaml`. */
+    name: string;
+    /** How the repo is sourced: cloned from a URL, mounted from a local path, or symlinked via `skaile repo link`. */
+    kind: "local" | "remote" | "linked";
+    /** Remote URL (present when `kind === "remote"`). */
+    url?: string;
+    /** Filesystem path (present when `kind === "local"` or `kind === "linked"`). */
+    path?: string;
+    /** Git branch configured for this repository. */
+    branch: string;
+    /** Whether the repository has been cloned/resolved locally. */
+    cloned: boolean;
+}
+/** The rendered native files of one locked agent that a deploy wrote with other content. */
+export interface RewrittenAgent {
+    /** Lock key of the agent asset. */
+    ref: string;
+    /** Project-relative POSIX paths of the files whose bytes changed. */
+    files: string[];
+}
+/** One deployed copy `install` made equal to its locked bytes again. */
+export interface RestoredAsset {
+    /** Canonical ref of the asset. */
+    ref: string;
+    /** Deployed files whose hand edit was overwritten (project-relative POSIX paths). */
+    restored: string[];
+    /** Files the asset does not ship that were deleted from its deployed directory. */
+    removed: string[];
+}
+/** One asset `install` moved from one locked version to another. */
+export interface ReplacedAsset {
+    /** `kind:@publisher/name`, no version. */
+    ref: string;
+    from: string;
+    to: string;
+}
+/**
+ * Result of a full `skaile install` or `skaile add` run.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+/** A locked store asset `install` did not re-check against the store; see {@link InstallResult.storeNotChecked}. */
+export interface StoreNotChecked {
+    /** The declared ref as `install` reports it (`kind:@publisher/name#version`). */
+    ref: string;
+    reason: "air-gapped" | "unreachable" | "skipped";
+    /** Why the store was not asked, or what it answered (the store URL and the cause). */
+    detail: string;
+}
+export interface InstallResult {
+    /** Canonical refs (`kind:@publisher/name#version`) successfully deployed in this run. */
+    deployed: string[];
+    /**
+     * Deployed library assets whose body is still the untouched `library create` scaffold: they
+     * fail `validate` and the publish plan, so `install` names them (p926). Absent when none is.
+     */
+    placeholderBodies?: string[];
+    /**
+     * Deployed library assets whose `description:` is still the `library create` placeholder
+     * (`TODO: …`): `validate` and the publish plan fail it as well. Absent when none is.
+     */
+    placeholderDescriptions?: string[];
+    /** Asset refs (`kind:name`) removed because they are no longer in the resolved set. */
+    removed: string[];
+    /**
+     * Asset refs that could not be resolved in any configured repository. On the
+     * non-locked path every entry is a bare ref; the reason a miss happened lives in
+     * {@link InstallResult.missingHints}. The `--locked` path still appends its prose
+     * (`ref (not found in library "x")`) to the entry, and also lists every
+     * {@link AssetManager.projectState} gap (a declared dependency or a locked asset's
+     * `requires` with no lock entry, a lock that contradicts a `skaile.yaml` pin, a library
+     * that cannot supply a locked asset) as its one-line message.
+     */
+    missing: string[];
+    /**
+     * Why a ref in {@link InstallResult.missing} may have missed, keyed by that ref:
+     * the asset's publisher changed (`library set publisher=`), so the lock still holds
+     * it under the old one and/or a library now holds it under another. Parenthesised
+     * parts such as `did you mean skill:@acme/x?` and
+     * `locked as skill:@plain/x; run skaile install to re-resolve`. Only refs with a
+     * hint appear; absent when none has.
+     */
+    missingHints?: Record<string, string>;
+    /**
+     * Locked store assets `install` could not check against the store (p792, p799): the deployed
+     * copy and the lock entry stay as they are and the asset is not in {@link InstallResult.missing}.
+     * `air-gapped` (`catalog.cache_ttl: 0`, nothing cached) and `skipped` (`update --no-catalog`)
+     * are a chosen mode, `unreachable` a store that did not answer. Absent when every locked store
+     * asset was checked.
+     */
+    storeNotChecked?: StoreNotChecked[];
+    /**
+     * Lock keys whose entry `install` rewrote for an asset that was already locked: the
+     * library or source holds another version of it, or the same version with other
+     * content. A re-lock can happen with nothing to deploy. Absent when none changed.
+     */
+    relocked?: string[];
+    /**
+     * Locked library assets whose library holds the locked version with other bytes (an edit with
+     * no version bump). `install` keeps their lock and deployed copy: only `skaile update` takes
+     * the edit (OQ13, p1911). Absent when none.
+     */
+    contentHeld?: ContentHeld[];
+    /**
+     * Global entries a 5.12.0 record left without a harness subset, now limited to the one harness
+     * that holds their copy (`ref` is `kind:@publisher/name`). Absent when nothing was inferred.
+     */
+    inferredHarnesses?: Array<{
+        ref: string;
+        harnesses: HarnessName[];
+    }>;
+    /**
+     * Library-origin assets whose lock entry now names another library than before. `install`
+     * keeps a locked asset on its library; only `update`, a pin, or a locked library that no
+     * longer holds the asset moves it. Absent when none moved.
+     */
+    moved?: LibraryMove[];
+    /**
+     * Assets whose locked version `install` replaced with another version of the same asset
+     * (`ref` is `kind:@publisher/name`). Not part of {@link InstallResult.removed}: nothing
+     * left the project. Absent when none changed.
+     */
+    replaced?: ReplacedAsset[];
+    /**
+     * Deployed copies `install` made equal to their locked bytes again: a file edited by hand
+     * (`restored`) or an extra file in the asset directory (`removed`), both as project-relative
+     * POSIX paths. Absent when every deployed copy already matched.
+     */
+    restored?: RestoredAsset[];
+    /**
+     * One line per locked library that is not registered here but whose assets `install --locked`
+     * restored from a store that serves the locked hash (every file SHA-verified): the notice that
+     * the library is not registered, where the bytes came from, and how to register it. Not a failure: `missing` stays empty (OQ8, p1655).
+     */
+    libraryNotices?: string[];
+    /**
+     * Rendered agent files that a lock without `rendered:` entries (written by a CLI before
+     * 5.12.0) did not cover and that this run wrote with other content, because the render of
+     * the agent changed. Absent when none.
+     */
+    rewritten?: RewrittenAgent[];
+    /** Whether `skaile.lock.yaml` was written or updated. */
+    lockWritten: boolean;
+    /**
+     * npm packages installed as a side effect of resolving runtime asset peer
+     * deps (connectors / mounts declared in skaile.yaml). Empty when nothing
+     * needed installing or when the runtime-deps step was skipped.
+     */
+    npmInstalled?: string[];
+    /**
+     * npm packages that the runtime-deps step tried but failed to install.
+     * 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[];
+    /**
+     * Ids of the `agentInstances` whose native agent files changed in this run (a new file,
+     * other bytes). An instance that rendered the same bytes again is not listed: `install`
+     * re-renders every instance each run (p1673).
+     */
+    agentInstancesChanged?: string[];
+    /**
+     * Workspace-relative native agent files removed because their instance left
+     * `skaile.yaml` (only files an earlier `skaile install` rendered are ever removed).
+     */
+    agentFilesRemoved?: string[];
+    /**
+     * Agent instances of `skaile.yaml` whose `ref` resolves to no agent (never added, or gone):
+     * one message each. Their earlier rendering is kept. `skaile install` fails on a non-empty list.
+     */
+    agentInstanceErrors?: string[];
+    /**
+     * The resolver's own text (with the directories it searched) for each entry of
+     * {@link agentInstanceErrors} whose message was shortened to one line of advice; for `--verbose`.
+     */
+    agentInstanceDetails?: string[];
+}
+/**
+ * A missing dependency detected by `AssetManager.doctor()`.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface DepIssue {
+    /** Kind of the asset that has the unsatisfied requirement. */
+    assetKind: string;
+    /** Name of the asset that has the unsatisfied requirement. */
+    assetName: string;
+    /** Kind of the missing dependency. */
+    depKind: string;
+    /** Name of the missing dependency (`@<publisher>/<name>` when it names a publisher). */
+    depName: string;
+    /** `true` when the missing dependency exists in a configured repository but has not been installed. */
+    inRepos: boolean;
+    /**
+     * `true` when the asset itself is lock-managed but no source or library holds it
+     * any more, so its `requires` cannot be checked. `depKind`/`depName` repeat the asset.
+     */
+    unresolved?: boolean;
+    /**
+     * Set with `unresolved` when the lock ties the asset to a library: what to change
+     * (`register library "x" again with …`, `did you mean <ref>?`). `skaile install`
+     * cannot restore it. Absent when the lock names no library for it.
+     */
+    fix?: string;
+}
+/**
+ * One way the project differs from what it declares and locks; see {@link AssetManager.projectState}.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface LockGap {
+    type: "declared" | "invalid" | "drift" | "pin" | "requires" | "unresolved" | "library" | "incomplete" | "content" | "modified" | "agent" | "flow" | "render" | "source";
+    /** The ref to act on: the declared ref, the unmet dependency `kind:name`, or the asset itself. */
+    ref: string;
+    /** Set on a `requires` gap: the requiring asset, `kind:@publisher/name` (`kind:name` when the lock knows no publisher). */
+    asset?: string;
+    /** What is wrong, as a phrase that follows `ref` (e.g. `is declared but not locked — run …`). */
+    reason: string;
+    /** One line naming the gap, without a leading status mark: `${ref} ${reason}`, except a `requires` gap, which leads with the requiring asset. */
+    message: string;
+    /** Set when `skaile install` cannot fix the gap; `reason` then names what to change instead. */
+    manualFix?: true;
+    /** Set on the gap of a `sources:` entry whose clone the walk could not read. `install --locked` restores from the lock alone, so it does not count that as missing. */
+    unreadableSource?: true;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/asset-manager/src/shared/types.d.ts.map

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

package/dist/bridge/harnesses/claude-sdk.js

@@ -1,31 +1,31 @@
 import { formatDroppedToolsNotice, filterInProcessMcpServerTools, checkToolPropertyKeys, TOOL_PROPERTY_KEY_PATTERN } from '../../chunk-3X7VTCPG.js';
 import { AskSlots } from '../../chunk-3TG2NV2F.js';
-import { scrubPoisonedTranscript, transcriptStoreForRuntime, resolveClaudeConfigDir, unsupportedSurfaceNotice, claudeEndpointMode, buildClaudeEndpointEnv, APPROVE_ONCE, DENY } from '../../chunk-QNHW26AT.js';
+import { scrubPoisonedTranscript, transcriptStoreForRuntime, resolveClaudeConfigDir, unsupportedSurfaceNotice, claudeEndpointMode, buildClaudeEndpointEnv, APPROVE_ONCE, DENY } from '../../chunk-OD4N5O7V.js';
 import { freshBudget, isFirstAttempt, spend, isSpent, decide, isAvailable } from '../../chunk-7EKQDY2T.js';
-import { dispatchCapability } from '../../chunk-GJT2Q5XD.js';
+import { dispatchCapability } from '../../chunk-HXST2IYJ.js';
 import { fetchProviderModels } from '../../chunk-U7EZ2WSC.js';
 import { harnessSpawnPath, resolveHarnessBinary, SDK_CLI_BINARIES } from '../../chunk-YKD2MYLU.js';
 import { ReconfigureLedger, AuthError, stripRunnerPrivateEnv, classifyClaudeSdkError, reclassifyAuthAsAccountUnavailable, AccountUnavailableError, isLongContextEntitlementRejection, LONG_CONTEXT_CREDITS_API_ERROR } from '../../chunk-5DE3DGVR.js';
 import { agentExecRequested, wrapAgentCommand, resolveAgentExec } from '../../chunk-7DN6JKP2.js';
-import { AgentHarness, getBridgeLogger, registryHarnessConfig } from '../../chunk-XHLRMUMO.js';
-import { BUILTIN_HARNESS_CATALOG, entryCredentialValue } from '../../chunk-3BRBTQ6M.js';
+import { AgentHarness, getBridgeLogger, registryHarnessConfig } from '../../chunk-NAQXDTF3.js';
+import { BUILTIN_HARNESS_CATALOG, harnessInfoFor, entryCredentialValue } from '../../chunk-S3UOZBGE.js';
 import '../../chunk-G5SUWZEU.js';
 import '../../chunk-6UP2EDFN.js';
-import { withActivityLabelShape } from '../../chunk-DWPQBMCY.js';
-import '../../chunk-LCXQ4LVP.js';
-import { loadHarnessSdk } from '../../chunk-MEU2HHGV.js';
+import { withActivityLabelShape } from '../../chunk-JPV4WE5L.js';
+import { loadHarnessSdk } from '../../chunk-U7P22GEB.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-CJO3XKO7.js';
+import '../../chunk-ETGC2MEM.js';
 import '../../chunk-5KRMNUL4.js';
 import '../../chunk-C5HFK34M.js';
 import '../../chunk-MWXYN6NY.js';
-import '../../chunk-BNLXZXZN.js';
+import '../../chunk-BRAOB37W.js';
 import '../../chunk-L5VSIPQD.js';
 import '../../chunk-VTETQCR6.js';
-import '../../chunk-MS2IXLTC.js';
-import '../../chunk-VS6XC5JE.js';
+import '../../chunk-PMXTBWFD.js';
+import '../../chunk-2MTRRK37.js';
 import '../../chunk-RVRB27AN.js';
-import '../../chunk-7HRZACI4.js';
+import '../../chunk-HW4BDJPC.js';
+import '../../chunk-LCXQ4LVP.js';
 import '../../chunk-VSX2G7LA.js';
 import { mergeRegistries, parseModelRef, isEntryEnabled, resolveEntryBaseUrl } from '../../chunk-RXGPFAMN.js';
 import '../../chunk-RZL4TOK3.js';
@@ -763,13 +763,7 @@ function withoutExpectedSdkWarnings(fn) {
   }
 }
 var ClaudeSdkHarness = class extends AgentHarness {
-  harnessInfo = {
-    id: "claude-sdk",
-    name: "Claude Agent SDK",
-    modelAgnostic: false,
-    supportsInBandAbort: true,
-    capabilities: BUILTIN_HARNESS_CATALOG["claude-sdk"]?.capabilities
-  };
+  harnessInfo = harnessInfoFor("claude-sdk");
   log = getBridgeLogger("claude-sdk");
   /** `kind: mcp` logger for tool-schema drops, alongside the runner's MCP rows. */
   mcpLog = createLogger({ kind: "mcp", subkind: "tool-schema-filter" });