@skaile/workspaces 0.24.0 → 0.26.0

package/dist/{ensure-sources-OJUBGX6Z.js → ensure-sources-CVULUVH4.js}

@@ -1,19 +1,20 @@
 import { logErr, logOk, logInfo } from './chunk-WSZAFRQL.js';
-import { skaileHomeDir } from './chunk-2F3RUZXC.js';
+import { skaileHomeDir } from './chunk-RTAIGPTF.js';
 import './chunk-R7FOF242.js';
-import './chunk-LJ52ZKIU.js';
+import './chunk-JIQLLZ65.js';
 import './chunk-OKRUTSG7.js';
-import { WorkspaceYamlEditor } from './chunk-Z3M5K67G.js';
+import { WorkspaceYamlEditor } from './chunk-KL2MQ6WI.js';
 import './chunk-K5GBV4SA.js';
-import './chunk-KLNL7QHN.js';
-import './chunk-5ESCS2OS.js';
-import './chunk-542K7SR6.js';
-import './chunk-DH4N5AW4.js';
-import './chunk-YX3UWPJ5.js';
+import './chunk-ZAP2BDHG.js';
+import './chunk-C32BRO2W.js';
+import './chunk-Z5DI7PDG.js';
+import './chunk-IERB3UXJ.js';
+import './chunk-2FS4FPZ7.js';
+import './chunk-IEJ5IOC3.js';
 import './chunk-JKNWJ64A.js';
 import './chunk-O4JH3KUE.js';
 import './chunk-24UIWON4.js';
-import './chunk-NELZIQ2E.js';
+import './chunk-QDJKE557.js';
 import './chunk-NSBPE2FW.js';
 import { spawnSync } from 'child_process';
 import { existsSync } from 'fs';
@@ -68,5 +69,5 @@ function ensureSourcesCloned(projectDir, opts = {}) {
 }
 
 export { ensureSourcesCloned };
-//# sourceMappingURL=ensure-sources-OJUBGX6Z.js.map
-//# sourceMappingURL=ensure-sources-OJUBGX6Z.js.map
+//# sourceMappingURL=ensure-sources-CVULUVH4.js.map
+//# sourceMappingURL=ensure-sources-CVULUVH4.js.map

package/dist/ensure-sources-CVULUVH4.js.map

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

package/dist/factory-assets/.skaile-source.yaml

@@ -0,0 +1,6 @@
+# Asset Source configuration for base-assets (connectors + mounts)
+# See: _devlog/specs/2026-05-03-ai-asset-store-v2-design.md
+
+version: 1
+publisher_default: '@skaile'
+default_ref: main

package/dist/factory-assets/README.md

@@ -0,0 +1,36 @@
+# workspaces-authoring asset set
+
+An AI-asset **source** (publisher `skaile-ai`) for people who *author* assets for
+[`@skaile/workspaces`](../packages/workspaces). It is itself a working example of
+the conventions it documents: a root `skaile.yaml` publication manifest plus
+skills laid out for the resolver.
+
+## Assets
+
+| Kind | Name | Purpose |
+|---|---|---|
+| skill | [`authoring-skaile-assets`](skills/authoring-skaile-assets/SKILL.md) | Author/restructure an asset repo: the 11 kinds, file layout, frontmatter, `requires` vs `dependencies`, local testing. |
+| skill | [`authoring-skaile-manifests`](skills/authoring-skaile-manifests/SKILL.md) | Write/fix/generate a `skaile.yaml`; the **canonical dependency standard**, version waterfall, conflict resolution, v3 lock file. |
+| skill | [`skaile-author-asset`](skills/skaile-author-asset/SKILL.md) | Build a skill in a local library and publish it: the source/library/store model, domain structure, and the `.skaile-source.yaml` manifest + publish flow. |
+| skill | [`skaile-manage-workspace`](skills/skaile-manage-workspace/SKILL.md) | Manage a workspace from the CLI: init/install, add/remove/list/search assets, sources, libraries, the manage TUI, patches, sessions. |
+| skill | [`manifest-compliance`](skills/manifest-compliance/SKILL.md) | Detect + fix non-canonical asset names/refs (the `parseAssetRef` hard error) across a repo via `skaile validate`. |
+| bundle | `workspaces-authoring` | Installs the authoring skills together. |
+
+The dependency standard is detailed in
+[`skills/authoring-skaile-manifests/references/dependency-standard.md`](skills/authoring-skaile-manifests/references/dependency-standard.md).
+
+## Use as a source
+
+```bash
+skaile init                       # in a consumer project
+skaile source add <this-repo-url>
+skaile source sync
+skaile add bundle:@skaile-ai/workspaces-authoring
+```
+
+## Maintaining this set
+
+`skaile.yaml` carries a **non-empty `assets:` list, so it is exhaustive** — when
+you add a skill/reference/bundle here, add a matching `assets:` entry (and keep
+each content `name:` equal to its `assets[].name`). Otherwise the new asset is
+browsable in `skaile manage` but fails `skaile add` with `Asset not found`.

package/dist/factory-assets/bundles/workspaces-authoring/workspaces-authoring.bundle.yaml

@@ -0,0 +1,9 @@
+name: workspaces-authoring
+version: 0.1.0
+description: "Author AI-asset repos that work with @skaile/workspaces and stores: asset content + skaile.yaml manifests + the canonical dependency standard."
+dependencies:
+  - skill:@skaile-ai/authoring-skaile-assets
+  - skill:@skaile-ai/authoring-skaile-manifests
+  - skill:@skaile-ai/skaile-author-asset
+  - skill:@skaile-ai/skaile-manage-workspace
+  - skill:@skaile-ai/manifest-compliance

package/dist/factory-assets/connectors/deploy/CONNECTOR.md

@@ -0,0 +1,41 @@
+---
+name: deploy
+description: "Build and push to remote deployment targets"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required: []
+  optional: []
+fields: []
+health_check: null
+keywords:
+  - service
+  - deploy
+  - build
+  - fly
+  - vercel
+---
+
+Build at a git ref and push to remote deployment targets. Supports mock, fly,
+vercel, docker-push, and rsync providers (only mock is fully implemented).
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `push` | write | Build and deploy |
+| `status` | read | Get deployment status |
+| `list` | read | List all deployments |
+| `teardown` | write | Remove a deployment |
+| `logs` | read | Fetch remote logs |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: deploy
+    adapter: deploy
+    access: read-write
+    options:
+      provider: mock
+```

package/dist/{base-assets → factory-assets}/connectors/deploy/adapter.d.ts

@@ -9,7 +9,7 @@ import type { ConnectContext, ConnectorDeclaration, ConnectorHandle, ToolFace }
 /**
  * Connector for building and deploying to remote targets.
  * Supports push, status, list, teardown, and logs operations. Currently implements the `mock` provider; fly, vercel, docker-push, and rsync are planned.
- * @docLink packages/base-assets/concepts#deploy-connector
+ * @docLink packages/factory-assets/concepts#deploy-connector
  */
 export declare class DeployConnector extends AbstractConnector {
     readonly name = "deploy";
@@ -33,7 +33,7 @@ export declare class DeployConnector extends AbstractConnector {
 /**
  * Creates a new DeployConnector instance.
  * @returns Configured DeployConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#deploy-connector-factory
+ * @docLink packages/factory-assets/api-reference#deploy-connector-factory
  */
 export declare function createConnector(): DeployConnector;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/factory-assets/connectors/deploy/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/deploy/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EAGf,QAAQ,EACT,MAAM,+BAA+B,CAAC;AAoBvC;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,QAAQ,CAAC,IAAI,YAAY;IAEzB,KAAK,EAAE,QAAQ,CAAC;;IAWV,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB1F,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIrE,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAMjF,OAAO,CAAC,mBAAmB;IA+D3B,OAAO,CAAC,cAAc;YAeR,UAAU;YAsBV,OAAO;IAuCrB,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,IAAI;CAWb;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAEjD"}

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

@@ -0,0 +1,22 @@
+export { DeployConnector, createConnector19 as createConnector } from '../../chunk-YDTW4GT6.js';
+import '../../chunk-ZYDE52WE.js';
+import '../../chunk-QMONOHXT.js';
+import '../../chunk-OVRSNIKJ.js';
+import '../../chunk-6E6PKKAD.js';
+import '../../chunk-W7W66MDZ.js';
+import '../../chunk-DEYYRFQU.js';
+import '../../chunk-IFGTRL2I.js';
+import '../../chunk-KL2MQ6WI.js';
+import '../../chunk-K5GBV4SA.js';
+import '../../chunk-ZAP2BDHG.js';
+import '../../chunk-C32BRO2W.js';
+import '../../chunk-Z5DI7PDG.js';
+import '../../chunk-IERB3UXJ.js';
+import '../../chunk-2FS4FPZ7.js';
+import '../../chunk-IEJ5IOC3.js';
+import '../../chunk-JKNWJ64A.js';
+import '../../chunk-O4JH3KUE.js';
+import '../../chunk-24UIWON4.js';
+import '../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=deploy.js.map
+//# sourceMappingURL=deploy.js.map

package/dist/factory-assets/connectors/devserver/CONNECTOR.md

@@ -0,0 +1,44 @@
+---
+name: devserver
+description: "Dev server process management with port allocation and health checks"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required: []
+  optional: []
+fields: []
+health_check: null
+keywords:
+  - service
+  - devserver
+  - process
+  - port
+  - health
+---
+
+Manage dev server processes (Vite, Nuxt, Next, etc.) with automatic port
+allocation, health checks, log capture, and optional git worktree isolation.
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `start` | write | Spawn a dev server process |
+| `register` | write | Track an externally started process |
+| `stop` | write | Stop an instance |
+| `restart` | write | Restart a managed instance |
+| `status` | read | Check instance health |
+| `logs` | read | Get recent stdout/stderr |
+| `list_instances` | read | List all tracked instances |
+| `free_port` | read | Allocate a port from the pool |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: dev
+    adapter: devserver
+    access: read-write
+    options:
+      port_range: [3000, 3099]
+```

package/dist/{base-assets → factory-assets}/connectors/devserver/adapter.d.ts

@@ -11,7 +11,7 @@ import type { ConnectContext, ConnectorDeclaration, ConnectorHandle, ToolFace }
 /**
  * Connector for managing dev server processes — spawns, tracks, and stops processes with port allocation, health checks, and log capture.
  * Supports optional git worktree isolation for per-instance code snapshots.
- * @docLink packages/base-assets/concepts#devserver-connector
+ * @docLink packages/factory-assets/concepts#devserver-connector
  */
 export declare class DevServerConnector extends AbstractConnector {
     readonly name = "devserver";
@@ -39,7 +39,7 @@ export declare class DevServerConnector extends AbstractConnector {
 /**
  * Creates a new DevServerConnector instance.
  * @returns Configured DevServerConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#devserver-connector-factory
+ * @docLink packages/factory-assets/api-reference#devserver-connector-factory
  */
 export declare function createConnector(): DevServerConnector;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/factory-assets/connectors/devserver/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/devserver/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,iBAAiB,EAKlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EAGf,QAAQ,EACT,MAAM,+BAA+B,CAAC;AA6DvC;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,QAAQ,CAAC,IAAI,eAAe;IAE5B,KAAK,EAAE,QAAQ,CAAC;;IAWV,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB1F,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKpE,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAQlE,QAAQ;YAQR,YAAY;IAuB1B,OAAO,CAAC,mBAAmB;YAuGb,UAAU;YAmCV,QAAQ;YAwFR,WAAW;YA0BX,OAAO;YAWP,UAAU;YAuBV,SAAS;YAWT,cAAc;IAkB5B,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,gBAAgB;YAeV,WAAW;IAIzB,OAAO,CAAC,cAAc;CAcvB;AAkBD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CAEpD"}

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

@@ -0,0 +1,22 @@
+export { DevServerConnector, createConnector16 as createConnector } from '../../chunk-YDTW4GT6.js';
+import '../../chunk-ZYDE52WE.js';
+import '../../chunk-QMONOHXT.js';
+import '../../chunk-OVRSNIKJ.js';
+import '../../chunk-6E6PKKAD.js';
+import '../../chunk-W7W66MDZ.js';
+import '../../chunk-DEYYRFQU.js';
+import '../../chunk-IFGTRL2I.js';
+import '../../chunk-KL2MQ6WI.js';
+import '../../chunk-K5GBV4SA.js';
+import '../../chunk-ZAP2BDHG.js';
+import '../../chunk-C32BRO2W.js';
+import '../../chunk-Z5DI7PDG.js';
+import '../../chunk-IERB3UXJ.js';
+import '../../chunk-2FS4FPZ7.js';
+import '../../chunk-IEJ5IOC3.js';
+import '../../chunk-JKNWJ64A.js';
+import '../../chunk-O4JH3KUE.js';
+import '../../chunk-24UIWON4.js';
+import '../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=devserver.js.map
+//# sourceMappingURL=devserver.js.map

package/dist/factory-assets/connectors/flow/CONNECTOR.md

@@ -0,0 +1,47 @@
+---
+name: flow
+description: "Live flow execution snapshot — agent-driven via tools, host-driven via connector_mutate"
+version: "0.1.0"
+entry: ./adapter.ts
+keywords:
+  - flow
+  - orchestration
+  - state-machine
+---
+
+The flow connector holds the live `FlowExecution` snapshot for one run and
+bridges three driving parties:
+
+- **Agent** — drives nodes by calling tools (`start_node`, `request_approval`,
+  `request_input`, `complete_node`, `skip_node`, `fail_node`, plus the
+  read-only `get_state`, `get_available`, `validate_node`, `build_handoff`).
+- **Host (runner)** — applies out-of-turn mutations through direct adapter
+  methods (`applyApproval`, `applyInput`, `retryNode`, `setAutonomousMode`,
+  `cancel`, `hydrate`) in response to user actions on the platform side.
+- **Orchestrator** — subscribes via `onStateChange` and forwards
+  `state_changed` events / kicks new turns after host-driven mutations.
+
+Every state mutation runs through a single `mutate()` pipeline that clones
+the current snapshot, applies the change, recomputes derived fields via
+`computeFlowStateFromSnapshots`, rolls up the flow-level status, and fires
+the registered `onChange` callback once. Consumers downstream (platform
+gateway, frontend hook) see latest-wins snapshots.
+
+Unlike the data connectors in this directory the flow adapter is not
+declared in `skaile.yaml` — it is constructed by the runner per session
+and bound to the active `FlowDefinition`.
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `get_available` | read | Node IDs ready to run |
+| `get_state` | read | Full flow execution snapshot |
+| `validate_node` | read | Is this node currently runnable |
+| `build_handoff` | read | Curated context from upstream nodes |
+| `start_node` | write | Mark a node `running` |
+| `request_approval` | write | Pause for human sign-off |
+| `request_input` | write | Pause for typed input |
+| `complete_node` | write | Finalise a node with output |
+| `skip_node` | write | Skip an optional node |
+| `fail_node` | write | Mark a node failed (recoverable or not) |

package/dist/{base-assets → factory-assets}/connectors/flow/adapter.d.ts

@@ -32,7 +32,7 @@ import { AbstractConnector, type ConnectContext, type ConnectorDeclaration, type
  * The runner's `SessionStimulusBus` from `runner/src/session-stimulus.ts`
  * satisfies this structurally; mocks in tests can implement it directly.
  *
- * @docLink packages/base-assets/flow#session-stimulus-bus
+ * @docLink packages/factory-assets/flow#session-stimulus-bus
  */
 export interface FlowAdapterStimulusBus {
     signal(connectorId: string, sig: {
@@ -197,7 +197,7 @@ export { isBlocking };
 /**
  * Creates a new FlowAdapter instance.
  * @returns Configured FlowAdapter ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#flow-connector-factory
+ * @docLink packages/factory-assets/api-reference#flow-connector-factory
  */
 export declare function createConnector(): FlowAdapter;
 //# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/flow/adapter.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,22 @@
+export { FlowAdapter, createConnector } from '../../../chunk-YDTW4GT6.js';
+import '../../../chunk-ZYDE52WE.js';
+import '../../../chunk-QMONOHXT.js';
+import '../../../chunk-OVRSNIKJ.js';
+import '../../../chunk-6E6PKKAD.js';
+export { isBlocking } from '../../../chunk-W7W66MDZ.js';
+import '../../../chunk-DEYYRFQU.js';
+import '../../../chunk-IFGTRL2I.js';
+import '../../../chunk-KL2MQ6WI.js';
+import '../../../chunk-K5GBV4SA.js';
+import '../../../chunk-ZAP2BDHG.js';
+import '../../../chunk-C32BRO2W.js';
+import '../../../chunk-Z5DI7PDG.js';
+import '../../../chunk-IERB3UXJ.js';
+import '../../../chunk-2FS4FPZ7.js';
+import '../../../chunk-IEJ5IOC3.js';
+import '../../../chunk-JKNWJ64A.js';
+import '../../../chunk-O4JH3KUE.js';
+import '../../../chunk-24UIWON4.js';
+import '../../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=adapter.js.map
+//# sourceMappingURL=adapter.js.map

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

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

package/dist/{base-assets → factory-assets}/connectors/flow/engine/flow-kind-provider.d.ts

@@ -1,7 +1,7 @@
 /**
  * Flow asset kind provider.
  *
- * Exported from @skaile/workspaces/base-assets/connectors/flow/engine for explicit registration
+ * Exported from @skaile/workspaces/factory-assets/connectors/flow/engine for explicit registration
  * by the CLI at bootstrap. Discovery does NOT auto-include this provider
  * (discovery must stay a leaf — no flow-engine imports).
  *

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-kind-provider.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/flow-kind-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,4BAA4B,CAAC;AAOpC,eAAO,MAAM,gBAAgB,EAAE,kBA6C9B,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-manifest.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/flow-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAMzB,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,yBAAyB,CAAC,CAAC,CAAC,GAAG,yBAAyB,CAAC;AAqBnG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAYlF"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,wBAAwB,IAAI,4BAA4B,GACzD,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAOzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAsBlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,EAAE,CActE"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../factory-assets/connectors/flow/engine/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+export { FlowManifestSchema, computeFlowState, computeFlowStateFromSnapshots, computeSkippable, flowKindProvider, isBlocking, loadAllFlows, loadFlow, loadFlowsFromDir, resolveNextNodes, validateFlow } from '../../../chunk-W7W66MDZ.js';
+import '../../../chunk-KL2MQ6WI.js';
+import '../../../chunk-K5GBV4SA.js';
+import '../../../chunk-ZAP2BDHG.js';
+import '../../../chunk-C32BRO2W.js';
+import '../../../chunk-Z5DI7PDG.js';
+import '../../../chunk-IERB3UXJ.js';
+import '../../../chunk-2FS4FPZ7.js';
+import '../../../chunk-IEJ5IOC3.js';
+import '../../../chunk-JKNWJ64A.js';
+import '../../../chunk-O4JH3KUE.js';
+import '../../../chunk-24UIWON4.js';
+import '../../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EACV,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/{base-assets → factory-assets}/connectors/flow/prompt-fragments.d.ts

@@ -10,7 +10,7 @@
  * The contract is byte-identical to the previous inline implementation —
  * any divergence is a regression.
  *
- * @docLink packages/base-assets/flow#prompt-fragments
+ * @docLink packages/factory-assets/flow#prompt-fragments
  */
 import type { FlowExecution } from "@skaile/workspaces/types";
 import type { FlowDefinition } from "./engine/types.js";
@@ -19,7 +19,7 @@ import type { FlowDefinition } from "./engine/types.js";
  * renders a stimulus-specific paragraph (via {@link renderStimulusPrompt}) so
  * the agent knows exactly why it has been invoked.
  *
- * @docLink packages/base-assets/flow#turn-stimulus
+ * @docLink packages/factory-assets/flow#turn-stimulus
  */
 export type TurnStimulus = {
     kind: "flow_started";
@@ -56,7 +56,7 @@ export type TurnStimulus = {
  * whitespace) describing why the runner has woken the agent. Spliced into
  * the orchestrator prompt under the `## Why this turn is happening` heading.
  *
- * @docLink packages/base-assets/flow#render-stimulus-prompt
+ * @docLink packages/factory-assets/flow#render-stimulus-prompt
  */
 export declare function renderStimulusPrompt(stimulus: TurnStimulus): string;
 /**
@@ -74,7 +74,7 @@ export declare function renderStimulusPrompt(stimulus: TurnStimulus): string;
  * Identical to `FlowOrchestrator.buildOrchestratorPrompt` (Phase 3 lift —
  * any divergence is a regression). Pure — depends only on its inputs.
  *
- * @docLink packages/base-assets/flow#build-orchestrator-prompt
+ * @docLink packages/factory-assets/flow#build-orchestrator-prompt
  * @since 2.2.0
  */
 export declare function buildOrchestratorPrompt(flowDef: FlowDefinition, state: FlowExecution, stimulus: TurnStimulus): string;
@@ -84,7 +84,7 @@ export declare function buildOrchestratorPrompt(flowDef: FlowDefinition, state:
  * trace events. The kind is always included; node-specific stimuli also
  * include their `nodeId` so log queries can pivot on it.
  *
- * @docLink packages/base-assets/flow#describe-stimulus
+ * @docLink packages/factory-assets/flow#describe-stimulus
  */
 export declare function describeStimulus(stimulus: TurnStimulus): string;
 //# sourceMappingURL=prompt-fragments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-fragments.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/flow/prompt-fragments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,2BAA2B,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9B;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAyBnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,YAAY,GACrB,MAAM,CAwFR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAmB/D"}

package/dist/{base-assets → factory-assets}/connectors/flow/prompt-fragments.js

@@ -1,4 +1,4 @@
-export { buildOrchestratorPrompt, describeStimulus, renderStimulusPrompt } from '../../../chunk-GZWJGNNN.js';
+export { buildOrchestratorPrompt, describeStimulus, renderStimulusPrompt } from '../../../chunk-DEYYRFQU.js';
 import '../../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=prompt-fragments.js.map
 //# sourceMappingURL=prompt-fragments.js.map

package/dist/{base-assets → factory-assets}/connectors/flow/run-flow.d.ts

@@ -1,22 +1,22 @@
 /**
  * runFlow / resumeFlow — CLI entry helpers for the flow connector.
  *
- * Moved from `runner/src/runner.ts` to `base-assets/connectors/flow/run-flow.ts`
+ * Moved from `runner/src/runner.ts` to `factory-assets/connectors/flow/run-flow.ts`
  * in Phase 3 of the flow-connector extraction (2026-05-08). Behaviour is
  * byte-identical to the previous runner-side implementation; only the log
  * source changes from `runner:flow:<runId>` to `flow-connector:run:<runId>`.
  *
  * The runner re-exports these symbols with a deprecation warning for one
  * release. CLI consumers should switch to
- * `import { runFlow, resumeFlow } from "@skaile/workspaces/base-assets/connectors/flow/run-flow"`.
+ * `import { runFlow, resumeFlow } from "@skaile/workspaces/factory-assets/connectors/flow/run-flow"`.
  *
  * Internal runner helpers (FlowOrchestrator, bootstrapRunnerLogStore,
  * createAgentSession, resolveDriverPaths, session helpers) are loaded lazily
  * via dynamic `await import("@skaile/workspaces/runner")` inside
  * `loadRunnerModule()` below. The lazy load avoids a static package-level
- * cycle (runner → connectors → base-assets → runner) — the cycle exists at
+ * cycle (runner → connectors → factory-assets → runner) — the cycle exists at
  * the workspace level but never resolves at module-load time because
- * base-assets only ever calls `import` from inside an async function body.
+ * factory-assets only ever calls `import` from inside an async function body.
  * The string-literal specifier preserves `bun --compile` and tsup static
  * analysis.
  */
@@ -29,7 +29,7 @@ export type SessionState = import("@skaile/workspaces/runner").SessionState;
  * Wraps `FlowOrchestrator` with autonomous mode turned on by default so
  * interactive approval/input gates don't block a terminal run.
  *
- * @docLink packages/base-assets/flow#run-flow
+ * @docLink packages/factory-assets/flow#run-flow
  */
 export interface RunOptions {
     /** The working directory for the project being orchestrated. */
@@ -92,7 +92,7 @@ export interface RunOptions {
  * resumable flow runs use a host that persists flow state (e.g. the Skaile
  * platform).
  *
- * @docLink packages/base-assets/flow#resume-flow
+ * @docLink packages/factory-assets/flow#resume-flow
  */
 export interface ResumeOptions {
     /** The working directory for the project being orchestrated. */
@@ -136,7 +136,7 @@ export interface ResumeOptions {
  * hosts (Skaile platform, Pichi) use the orchestrator directly via the
  * serve command surface and drive gates through user actions.
  *
- * @docLink packages/base-assets/flow#run-flow
+ * @docLink packages/factory-assets/flow#run-flow
  */
 export declare function runFlow(opts: RunOptions): Promise<void>;
 /**
@@ -153,7 +153,7 @@ export declare function runFlow(opts: RunOptions): Promise<void>;
  * driver-level convenience only: we load the session, restart the
  * flow, and the SDK will reconnect to the prior conversation thread.
  *
- * @docLink packages/base-assets/flow#resume-flow
+ * @docLink packages/factory-assets/flow#resume-flow
  */
 export declare function resumeFlow(opts: ResumeOptions): Promise<void>;
 //# sourceMappingURL=run-flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-flow.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/flow/run-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAsC5D,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,OAAO,2BAA2B,EAAE,YAAY,CAAC;AAK5E;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC7B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwQ7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDnE"}

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

@@ -0,0 +1,25 @@
+export { resumeFlow, runFlow } from '../../../chunk-QHXS3YDV.js';
+import '../../../chunk-ZONCCO5N.js';
+import '../../../chunk-TV72ZJYN.js';
+import '../../../chunk-YDTW4GT6.js';
+import '../../../chunk-ZYDE52WE.js';
+import '../../../chunk-QMONOHXT.js';
+import '../../../chunk-OVRSNIKJ.js';
+import '../../../chunk-6E6PKKAD.js';
+import '../../../chunk-W7W66MDZ.js';
+import '../../../chunk-DEYYRFQU.js';
+import '../../../chunk-IFGTRL2I.js';
+import '../../../chunk-KL2MQ6WI.js';
+import '../../../chunk-K5GBV4SA.js';
+import '../../../chunk-ZAP2BDHG.js';
+import '../../../chunk-C32BRO2W.js';
+import '../../../chunk-Z5DI7PDG.js';
+import '../../../chunk-IERB3UXJ.js';
+import '../../../chunk-2FS4FPZ7.js';
+import '../../../chunk-IEJ5IOC3.js';
+import '../../../chunk-JKNWJ64A.js';
+import '../../../chunk-O4JH3KUE.js';
+import '../../../chunk-24UIWON4.js';
+import '../../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=run-flow.js.map
+//# sourceMappingURL=run-flow.js.map

package/dist/{base-assets → factory-assets}/connectors/flow/stimulus-driver.d.ts

@@ -20,7 +20,7 @@
  * received, input-received, etc.) once the orchestrator's onStateChange
  * subscription is removed; until then we keep gating purely on equality.
  *
- * @docLink packages/base-assets/flow#stimulus-driver
+ * @docLink packages/factory-assets/flow#stimulus-driver
  */
 import type { FlowExecution } from "@skaile/workspaces/types";
 import type { TurnStimulus } from "./prompt-fragments.js";
@@ -36,7 +36,7 @@ import type { TurnStimulus } from "./prompt-fragments.js";
  * @param newExec - Current FlowExecution snapshot.
  * @returns A {@link TurnStimulus} when a turn should be kicked, or `null`.
  *
- * @docLink packages/base-assets/flow#compute-stimulus
+ * @docLink packages/factory-assets/flow#compute-stimulus
  */
 export declare function computeStimulus(oldExec: FlowExecution | undefined, newExec: FlowExecution): TurnStimulus | null;
 //# sourceMappingURL=stimulus-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stimulus-driver.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/flow/stimulus-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,OAAO,EAAE,aAAa,GACrB,YAAY,GAAG,IAAI,CAqBrB"}