@skaile/workspaces 0.24.0 → 0.26.0

package/dist/factory-assets/connectors/flow/stimulus-driver.js

@@ -0,0 +1,4 @@
+export { computeStimulus } from '../../../chunk-IFGTRL2I.js';
+import '../../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=stimulus-driver.js.map
+//# sourceMappingURL=stimulus-driver.js.map

package/dist/factory-assets/connectors/flow.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';
+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=flow.js.map
+//# sourceMappingURL=flow.js.map

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

@@ -0,0 +1,145 @@
+---
+name: git
+description: "Git repository connector with clone/pull, session branching, and lifecycle hooks."
+version: "0.1.0"
+entry: ./driver.ts
+fields:
+  - key: source
+    label: "Git repository URL"
+    required: true
+    sensitive: false
+  - key: auth
+    label: "Auth (provider-prefixed; pat:env:NAME, oauth:<provider>/env:VAR, github-app:APP_ID/INSTALLATION_ID)"
+    required: false
+    sensitive: true
+  - key: exposeAccessToken
+    label: "Expose access token to agent CLI (advanced; expert-only)"
+    required: false
+    sensitive: true
+  - key: accessTokenTTL
+    label: "Override access token TTL in seconds (refresh-capable providers only)"
+    required: false
+    sensitive: false
+  - key: options.branch
+    label: "Branch to track"
+    required: false
+    sensitive: false
+  - key: options.session.enabled
+    label: "Enable session branching"
+    required: false
+    sensitive: false
+  - key: options.session.slug
+    label: "Session branch slug"
+    required: false
+    sensitive: false
+  - key: options.session.branchPrefix
+    label: "Session branch prefix"
+    required: false
+    sensitive: false
+  - key: options.sync.fetchIntervalSec
+    label: "Periodic fetch interval (seconds, 0 = disabled)"
+    required: false
+    sensitive: false
+  - key: options.sync.autoRebase
+    label: "Auto-rebase on fetch"
+    required: false
+    sensitive: false
+  - key: options.lifecycle.commitOnHibernate
+    label: "Commit on hibernate"
+    required: false
+    sensitive: false
+  - key: options.lifecycle.pushOnHibernate
+    label: "Push on hibernate"
+    required: false
+    sensitive: false
+  - key: options.lifecycle.mergeOnClose
+    label: "Merge session branch on close"
+    required: false
+    sensitive: false
+  - key: options.lifecycle.autoCommitIdleMs
+    label: "Auto-commit after idle (ms, 0 = disabled)"
+    required: false
+    sensitive: false
+keywords:
+  - git
+  - repository
+  - clone
+  - branch
+  - session
+---
+
+## Git Connector
+
+Connects a git repository by cloning (or pulling) to the session filesystem mount point.
+Supports session-aware branching, periodic fetch/rebase, auto-commit on idle,
+and lifecycle hooks for hibernate/close.
+
+### Configuration
+
+```yaml
+connectors:
+  - id: project-repo
+    driver: git
+    access: read-write
+    # Provider-prefixed auth grammar (clean break from the legacy bare `env:`):
+    #   pat:env:NAME                       — long-lived PAT (no refresh)
+    #   oauth:<provider>/env:VAR           — refresh-capable OAuth (Step 2/3)
+    #   github-app:APP_ID/INSTALLATION_ID  — refresh-capable GitHub App (Step 2)
+    auth: pat:env:GIT_TOKEN
+    mount:
+      source: https://github.com/org/repo.git
+      # Expert-only. Default `false`. When `true`, the runner writes a
+      # short-lived credential into `<workspace>/.skaile/managed-gitconfig`
+      # so the agent's interactive `git push` / `git pull` can authenticate.
+      # Sensitive: gives prompt-injected agents direct CLI access bounded by
+      # the credential's TTL (no refresh on PAT — blast radius = PAT scope).
+      # See _devlog/specs/2026-05-05-git-credential-tiers.md.
+      exposeAccessToken: false
+      # Optional override for the access token TTL (seconds). Capped at the
+      # provider's documented maximum.
+      accessTokenTTL: 3600
+    options:
+      branch: main
+      session:
+        enabled: true
+        slug: session-123
+        branchPrefix: "session/"
+      sync:
+        fetchIntervalSec: 60
+        autoRebase: true
+      lifecycle:
+        commitOnHibernate: true
+        pushOnHibernate: true
+        mergeOnClose: true
+        autoCommitIdleMs: 30000
+```
+
+### Credential tiers
+
+The git driver supports two credential tiers, gated by the `mount.exposeAccessToken`
+field (default off):
+
+| Tier | When | What the agent sees |
+|---|---|---|
+| Tier 1 (default) | `exposeAccessToken: false` | No credential. Driver-internal pulls/pushes use ephemeral `http.<scope>.extraheader`. Agent native `git push` / `pull` against the remote fails by design. |
+| Tier 2 (opt-in) | `exposeAccessToken: true` | Short-lived access token written to `<workspace>/.skaile/managed-gitconfig` + `git-credentials`. Agent native git CLI works for the mount's host. |
+
+`auth:` is **required** to use a provider-prefixed grammar:
+
+| Syntax | Refresh capability |
+|---|---|
+| `pat:env:NAME` | None — static long-lived PAT. |
+| `oauth:<provider>/env:VAR` | Refresh-capable (Step 2/3). |
+| `github-app:APP_ID/INSTALLATION_ID` | Refresh-capable (Step 2). |
+
+The legacy bare `env:NAME` form is rejected at session start with a clear
+migration error pointing at this doc.
+
+### Behavior
+
+- **mount**: Clones the repo (or pulls if `.git` exists). Creates a session branch if configured.
+- **unmount**: Stops periodic fetch and auto-commit timers.
+- **sync**: Pulls from origin on the active branch.
+- **watch**: Uses chokidar with `.git/**` ignored. Resets the auto-commit idle timer on changes.
+- **onHibernate**: Commits and optionally pushes all changes.
+- **onSessionClose**: Commits, pushes, and optionally merges the session branch into the base branch. Handles merge conflicts by keeping "ours" and saving "theirs" as `.conflict` files.

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

@@ -17,7 +17,7 @@ import { AbstractConnector } from "@skaile/workspaces/connectors";
  * `access_token_response` event). Local provider minting (OAuth, GitHub App)
  * has been removed — the platform owns dispatch.
  *
- * @docLink packages/base-assets/concepts#git-connector
+ * @docLink packages/factory-assets/concepts#git-connector
  */
 export declare class GitConnector extends AbstractConnector {
     readonly name = "git";
@@ -183,7 +183,7 @@ export declare class GitConnector extends AbstractConnector {
 /**
  * Creates a new GitConnector instance.
  * @returns Configured GitConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#git-connector-factory
+ * @docLink packages/factory-assets/api-reference#git-connector-factory
  */
 export declare function createConnector(): GitConnector;
 //# sourceMappingURL=driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/git/driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EAMd,WAAW,EACX,YAAY,EACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EAUlB,MAAM,+BAA+B,CAAC;AAsNvC;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,QAAQ,CAAC,IAAI,SAAS;IAEtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAIjC;IAEI,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA+L/F;;;OAGG;YACW,mBAAmB;IA2CjC;;;;;;;;;;;;;;;OAeG;IACG,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCrF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAqB1C,KAAK;IAsBV,KAAK,CACZ,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC/C,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW;IAiDC,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA4BjE,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuDnF;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;;;;;;;;;;;OAeG;YACW,mBAAmB;IA8DjC,OAAO,CAAC,uBAAuB;IAmG/B;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;YAcT,wBAAwB;IAmDtC,OAAO,CAAC,yBAAyB;IA8BjC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,4BAA4B;IAkCpC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,kBAAkB;IA0B1B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAkD/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,qBAAqB;CAa9B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}

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

@@ -0,0 +1,22 @@
+export { GitConnector, createConnector2 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=git.js.map
+//# sourceMappingURL=git.js.map

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

@@ -0,0 +1,50 @@
+---
+name: gmail
+description: "Connect to Gmail via Google API OAuth"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required:
+    - googleapis
+  optional: []
+fields:
+  - key: account
+    label: "Gmail Account"
+    required: true
+    sensitive: false
+  - key: auth
+    label: "Authentication"
+    required: true
+    sensitive: true
+health_check: list_messages
+keywords:
+  - email
+  - gmail
+  - google
+  - oauth
+---
+
+Connect an agent to Gmail for reading and writing email. Requires OAuth
+authentication via Google APIs.
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `list_messages` | read | List messages in inbox or label |
+| `get_message` | read | Fetch a full message by ID |
+| `search_messages` | read | Search using Gmail query syntax |
+| `send_message` | write | Send an email |
+| `create_draft` | write | Create a draft without sending |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: email
+    adapter: gmail
+    access: read-write
+    auth: oauth:google:user@gmail.com
+    options:
+      account: user@gmail.com
+```

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

@@ -9,7 +9,7 @@ import type { ConnectContext, ConnectorDeclaration, ConnectorFieldSpec, Connecto
 /**
  * Connector for Gmail — provides read and send access to email messages and drafts via the Google API.
  * Authenticates using OAuth2 (managed by OAuthSecretProvider). Requires the `googleapis` optional peer dependency.
- * @docLink packages/base-assets/concepts#gmail-connector
+ * @docLink packages/factory-assets/concepts#gmail-connector
  */
 export declare class GmailConnector extends AbstractConnector {
     readonly name = "gmail";
@@ -26,7 +26,7 @@ export declare class GmailConnector extends AbstractConnector {
 /**
  * Creates a new GmailConnector instance.
  * @returns Configured GmailConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#gmail-connector-factory
+ * @docLink packages/factory-assets/api-reference#gmail-connector-factory
  */
 export declare function createConnector(): GmailConnector;
 //# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/gmail/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAe,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAGf,QAAQ,EACT,MAAM,+BAA+B,CAAC;AAQvC;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,IAAI,WAAW;IAExB,KAAK,EAAE,QAAQ,CAAC;;IAWhB,cAAc,IAAI,kBAAkB,EAAE;IAwBhC,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,mBAAmB;YAuEb,UAAU;IA0DxB,OAAO,CAAC,gBAAgB;CAmBzB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAEhD"}

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

@@ -0,0 +1,22 @@
+export { GmailConnector, createConnector14 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=gmail.js.map
+//# sourceMappingURL=gmail.js.map

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

@@ -0,0 +1,150 @@
+---
+name: googledrive
+description: "Google Drive (Google Files) connector via rclone FUSE."
+version: "0.1.0"
+entry: ./driver.ts
+fields:
+  - key: auth
+    label: "Bearer token, service-account JSON path, or JSON credential bundle"
+    required: true
+    sensitive: true
+  - key: options.scope
+    label: "OAuth scope (drive | drive.readonly | drive.file | drive.appfolder | drive.metadata.readonly). Default: drive"
+    required: false
+    sensitive: false
+  - key: options.rootFolderId
+    label: "Drive folder ID to mount as the remote root"
+    required: false
+    sensitive: false
+  - key: options.teamDrive
+    label: "Shared Drive (Team Drive) ID"
+    required: false
+    sensitive: false
+  - key: options.basePath
+    label: "Subfolder appended under the remote root"
+    required: false
+    sensitive: false
+  - key: options.cacheMaxSize
+    label: "rclone VFS cache size cap (e.g. '5G'). Default: 5G"
+    required: false
+    sensitive: false
+  - key: options.cacheMaxAge
+    label: "rclone VFS cache age cap (e.g. '168h'). Default: 168h"
+    required: false
+    sensitive: false
+  - key: options.vfsWriteBack
+    label: "rclone VFS write-back delay before upload (e.g. '30s', '1m'). Default: 30s"
+    required: false
+    sensitive: false
+keywords:
+  - google
+  - googledrive
+  - google-drive
+  - google-files
+  - drive
+  - rclone
+---
+
+## Google Drive Connector
+
+Exposes a Google Drive folder (or Shared Drive) via rclone's FUSE backend. The
+driver delegates the entire data plane (enumeration, download, upload, change
+detection, cache management) to an `rclone mount` subprocess managed by
+`RcloneProcessManager`.
+
+### Configuration
+
+```yaml
+connectors:
+  - id: project-drive
+    driver: googledrive
+    access: read-write
+    auth: env:GDRIVE_TOKEN
+    options:
+      scope: drive
+      rootFolderId: 0Abc123XYZdefg
+      basePath: subfolder/optional
+      cacheMaxSize: 5G
+      cacheMaxAge: 168h
+      vfsWriteBack: 30s
+```
+
+`vfsWriteBack` controls rclone's `--vfs-write-back` — how long a dirty file
+sits before upload. Default raised from 5s to 30s so a rapidly-rewritten file
+settles before transfer instead of aborting with `sizes differ`.
+
+`rootFolderId` (optional) restricts the mount to a subtree. Without it the
+remote root is the user's "My Drive". `teamDrive` (optional) points the mount
+at a Shared Drive — set both for a subtree inside a Shared Drive.
+
+### Authentication
+
+The `auth` field can be:
+
+- A plain OAuth Bearer token string (rclone has no refresh path; on 401 the
+  next session start re-provisions a fresh token from the platform DB).
+- A JSON object with OAuth refresh support — emitted into the rclone config so
+  rclone can refresh autonomously:
+  ```json
+  {
+    "accessToken": "...",
+    "refreshToken": "...",
+    "expiresAt": 1234567890,
+    "clientId": "...",
+    "clientSecret": "..."
+  }
+  ```
+- A JSON object pointing at a service-account file:
+  ```json
+  { "serviceAccountFile": "/etc/skaile/gdrive-sa.json" }
+  ```
+
+### Scopes
+
+The `options.scope` field maps to rclone's `scope =` for the Google Drive
+backend:
+
+| Scope | Effect |
+|---|---|
+| `drive` (default) | Full read/write access |
+| `drive.readonly` | Read-only access |
+| `drive.file` | Only files the app created or opened |
+| `drive.appfolder` | The app's hidden data folder |
+| `drive.metadata.readonly` | Metadata only |
+
+### Implementation: rclone FUSE
+
+- **mount**: Renders an `[skaile-<id>]` rclone config (`drive` backend, OAuth
+  token JSON or service-account file, optional root/team-drive restrictions),
+  spawns `rclone mount` with VFS caching, returns once the FUSE mountpoint is
+  confirmed in `/proc/self/mounts`.
+- **VFS cache mode**: `read-only` mounts use `minimal`; `read-write` uses
+  `full` so writes are buffered locally before upload.
+- **Cache directory**: `/var/cache/skaile/<mountId>` (the parent
+  `/var/cache/skaile` is bind-mounted from the host per session).
+- **sync**: Calls `RcloneProcessManager.flush` (POSTs `/vfs/refresh` then waits
+  for the in-use counter to reach zero).
+- **unmount**: `RcloneProcessManager.stop` flushes, sends SIGTERM, falls back
+  to SIGKILL + `fusermount3 -u` after a 30s grace.
+- **onHibernate / onSessionClose**: Always flush. Cheap and the right default;
+  no opt-out toggles.
+- **Logs**: rclone subprocess JSON log lines are routed through a child logger
+  with subkind `googledrive+rclone`, alongside the driver's own `googledrive`
+  entries — both visible via `skaile session logs --kind connector`.
+
+### Fleet-managed mode
+
+When the `SKAILE_FLEET_MANAGED_MOUNTS` env var lists this mount's id, the
+host-side `RcloneFleetService` (in the platform backend) has already spawned
+a shared `rclone mount` process and bind-mounted its FUSE mountpoint into the
+container at the driver's `targetDir`. The driver short-circuits its own
+rclone spawn:
+
+- `mount()` verifies the bind mount is live (`stat` + `readdir` poll up to
+  3s), then returns a no-op handle with `state.fleetManaged = true`.
+- `unmount()`, `sync()`, `onHibernate()`, `onSessionClose()` all return early
+  — the fleet owns the rclone process and is responsible for flushing and
+  teardown.
+
+The env var is comma-separated; an empty / unset value preserves the
+per-session behaviour described above.

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

@@ -22,7 +22,7 @@ interface ParsedAuth {
  * `rclone mount` subprocess via `RcloneProcessManager` using the `drive` backend.
  * Supports OAuth2 access tokens with optional refresh, service-account JSON files,
  * and fleet-managed mode via `SKAILE_FLEET_MANAGED_MOUNTS`.
- * @docLink packages/base-assets/concepts#googledrive-connector
+ * @docLink packages/factory-assets/concepts#googledrive-connector
  */
 export declare class GoogleDriveConnector extends AbstractConnector {
     readonly name = "googledrive";
@@ -37,7 +37,7 @@ export declare class GoogleDriveConnector extends AbstractConnector {
 /**
  * Creates a new GoogleDriveConnector instance.
  * @returns Configured GoogleDriveConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#googledrive-connector-factory
+ * @docLink packages/factory-assets/api-reference#googledrive-connector-factory
  */
 export declare function createConnector(): GoogleDriveConnector;
 export declare function parseAuthBlob(raw: string | undefined, log?: {

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/googledrive/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,cAAc,EAKf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EAOlB,MAAM,+BAA+B,CAAC;AAOvC,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAWD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,MAAM,CAA8B;IAE5C,QAAQ,CAAC,UAAU,EAAE,cAAc,CAKjC;IAEI,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAqGzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAM1C,KAAK;IAuBJ,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAOjE,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAMpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,oBAAoB,CAEtD;AAID,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACnD,UAAU,CAyCZ"}

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

@@ -0,0 +1,22 @@
+export { GoogleDriveConnector, createConnector7 as createConnector, parseAuthBlob } 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=googledrive.js.map
+//# sourceMappingURL=googledrive.js.map

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

@@ -0,0 +1,40 @@
+---
+name: local
+description: "Passthrough connector to a local directory — copies source files into the filesystem mount point."
+version: "0.1.0"
+entry: ./driver.ts
+fields:
+  - key: source
+    label: "Source directory path"
+    required: true
+    sensitive: false
+keywords:
+  - local
+  - filesystem
+  - directory
+  - bind
+---
+
+## Local Connector
+
+Projects a local directory into the session filesystem mount point by copying
+its contents. If the source and target paths are identical (or target is inside
+source), the copy step is skipped and the directory is used in place.
+
+### Configuration
+
+```yaml
+connectors:
+  - id: my-files
+    driver: local
+    access: read-write
+    mount:
+      source: ./path/to/directory
+```
+
+### Behavior
+
+- **mount**: Copies the source directory into `targetDir` recursively.
+- **unmount**: No-op (does not delete the mount directory).
+- **sync**: Re-copies from source to target.
+- **watch**: Uses chokidar filesystem watcher on the mount path.

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

@@ -9,7 +9,7 @@ import { AbstractConnector } from "@skaile/workspaces/connectors";
  * Filesystem-face connector for local filesystem directories — copies the source directory
  * into the mount target on connect and syncs on demand.
  * No external dependencies; ideal for development and local file access.
- * @docLink packages/base-assets/concepts#local-connector
+ * @docLink packages/factory-assets/concepts#local-connector
  */
 export declare class LocalConnector extends AbstractConnector {
     readonly name = "local";
@@ -22,7 +22,7 @@ export declare class LocalConnector extends AbstractConnector {
 /**
  * Creates a new LocalConnector instance.
  * @returns Configured LocalConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#local-connector-factory
+ * @docLink packages/factory-assets/api-reference#local-connector-factory
  */
 export declare function createConnector(): LocalConnector;
 //# sourceMappingURL=driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/local/driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAGV,WAAW,EACX,YAAY,EACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAOlE;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,IAAI,WAAW;IAExB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAIjC;IAEI,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA8BzF,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAK3C,KAAK;IAkBV,KAAK,CACZ,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC/C,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW;CAwBf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAEhD"}

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

@@ -0,0 +1,22 @@
+export { LocalConnector, createConnector3 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=local.js.map
+//# sourceMappingURL=local.js.map

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

@@ -0,0 +1,65 @@
+---
+name: mattermost
+description: "Team messaging via Mattermost REST API v4"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required: []
+  optional: []
+fields:
+  - key: url
+    label: "Server URL"
+    required: true
+    sensitive: false
+  - key: token
+    label: "Bot Token"
+    required: true
+    sensitive: true
+  - key: channels
+    label: "Channel Filter"
+    required: false
+    sensitive: false
+health_check: list_channels
+keywords:
+  - messaging
+  - mattermost
+  - chat
+  - bot
+---
+
+Connect an agent to Mattermost for reading and writing messages. Uses native
+`fetch` for REST calls — no npm packages required.
+
+## Operations
+
+### Read
+
+| Operation | Description |
+|-----------|-------------|
+| `list_channels` | List channels the bot can access |
+| `get_channel` | Get channel details by ID |
+| `list_posts` | List recent posts in a channel |
+| `get_thread` | Get all posts in a thread |
+| `search_posts` | Full-text search across channels |
+| `get_user` | Get user info by ID |
+
+### Write
+
+| Operation | Description |
+|-----------|-------------|
+| `create_post` | Post a message to a channel |
+| `reply_to_thread` | Reply within an existing thread |
+| `update_post` | Edit an existing post |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: team-chat
+    adapter: mattermost
+    access: read-write
+    auth: env:MM_BOT_TOKEN
+    options:
+      url: https://chat.example.com
+      channels: "channel-id-1,channel-id-2"
+```