@skaile/workspaces 5.6.1 → 5.8.0

package/dist/asset-manager/src/install-agent.d.ts

@@ -20,6 +20,17 @@
  * host-executed and get no native file.
  */
 import type { AgentInstanceConfig, SkWorkspaceConfig } from "@skaile/workspaces/core";
+import { type AgentManifest } from "./renderers.js";
+/**
+ * The agent's manifest: `agent.yaml`, else the frontmatter of the legacy
+ * `AGENT.md`. `null` when the directory holds neither (or it cannot be parsed).
+ */
+export declare function readManifest(agentDir: string): AgentManifest | null;
+/**
+ * The agent's identity text: `SOUL.md`; for an `AGENT.md` agent the markdown body
+ * comes first, so a `SOUL.md` next to it extends the prompt rather than replacing it.
+ */
+export declare function readSoul(agentDir: string): string | null;
 /**
  * Install a single GitAgent source directory using the appropriate renderer.
  *

package/dist/asset-manager/src/install-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-agent.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/install-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAgB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAsSpG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM;AACpB,wEAAwE;AACxE,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,gBAAgB,EAAE,OAAO,EACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC3B,QAAQ,CAAC,EAAE,mBAAmB,GAC7B;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAoG3C"}
+{"version":3,"file":"install-agent.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/install-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAgB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAkBpG,OAAO,EAAE,KAAK,aAAa,EAAiD,MAAM,gBAAgB,CAAC;AAwCnG;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQnE;AAYD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AA+PD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM;AACpB,wEAAwE;AACxE,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,gBAAgB,EAAE,OAAO,EACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC3B,QAAQ,CAAC,EAAE,mBAAmB,GAC7B;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAoG3C"}

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

@@ -4,7 +4,7 @@
  */
 import type { AiComponent, CatalogEntry, DriverTarget, SourceDeclaration } from "@skaile/workspaces/core";
 import type { IAssetKindRegistry } from "@skaile/workspaces/plugins";
-import type { Log } from "./renderers.js";
+import { type Log } from "./renderers.js";
 export type { Log } from "./renderers.js";
 /**
  * The printable canonical ref of a resolved entry — `kind:@publisher/name#version`,
@@ -105,6 +105,8 @@ export declare function deployAll(resolved: DeployableEntry[], repositories: Rec
  * @docLink packages/asset-manager/api-reference#installer
  */
 export declare function removeAsset(kind: string, name: string, opts: DeployOptions): boolean;
+/** Asset kinds {@link createScaffold} has a real template for. */
+export declare const SCAFFOLD_KINDS: readonly ["skill", "agent", "prompt", "flow", "preset", "contract"];
 /** Options for {@link createScaffold}. */
 export interface ScaffoldOptions {
     /**
@@ -117,7 +119,7 @@ export interface ScaffoldOptions {
 /**
  * Create a minimal scaffold directory for a new asset.
  *
- * Writes the appropriate manifest file (`SKILL.md`, `AGENT.md`, `CONTRACT.md`,
+ * Writes the appropriate manifest file (`SKILL.md`, `agent.yaml` + `SOUL.md`, `CONTRACT.md`,
  * `<name>.preset.yaml`, `<name>.flow.yaml`, or `<name>.prompt.md`) inside a
  * new `<destDir>/<name>/` directory.
  *
@@ -126,7 +128,8 @@ export interface ScaffoldOptions {
  * @param destDir - Parent directory to create the asset in.
  * @param opts - Optional scaffold content ({@link ScaffoldOptions}).
  * @returns `{ ok: true, path }` on success, `{ ok: false, path: errorMessage }` if the
- *   directory already exists.
+ *   directory already exists or `kind` is not one of {@link SCAFFOLD_KINDS}
+ *   (`Cannot scaffold kind "<kind>". Expected: ...`); nothing is created then.
  * @docLink packages/asset-manager/api-reference#installer
  */
 export declare function createScaffold(name: string, kind: string, destDir: string, opts?: ScaffoldOptions): {

package/dist/asset-manager/src/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAgBjC,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAE1C,YAAY,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAI1C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAU7D;AAYD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAEzB;AAaD;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAwDD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+GAA+G;IAC/G,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC/C,IAAI,EAAE,aAAa,EACnB,GAAG,GAAE,GAAU,GACd,OAAO,CA2DT;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,eAAe,EAAE,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,aAAa,EACnB,GAAG,GAAE,GAAU,GACd,MAAM,EAAE,CA4FV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAiBpF;AA2CD,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,eAAoB,GACzB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqC/B"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAoBjC,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAsB,KAAK,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAE9D,YAAY,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAI1C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAU7D;AAYD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAEzB;AAaD;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAwDD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+GAA+G;IAC/G,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC/C,IAAI,EAAE,aAAa,EACnB,GAAG,GAAE,GAAU,GACd,OAAO,CAiET;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,eAAe,EAAE,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,aAAa,EACnB,GAAG,GAAE,GAAU,GACd,MAAM,EAAE,CAiGV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAgCpF;AA4DD,kEAAkE;AAClE,eAAO,MAAM,cAAc,qEAAsE,CAAC;AAElG,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,eAAoB,GACzB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA2C/B"}