@skaile/workspaces 0.25.0 → 0.26.0

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

@@ -9,7 +9,7 @@ import type { ConnectContext, ConnectorDeclaration, ConnectorFieldSpec, Connecto
 /**
  * Connector for Mattermost — reads and posts messages via the REST API v4.
  * No npm peer dependencies; uses native fetch and Bun WebSocket. Authenticates with a bot token.
- * @docLink packages/base-assets/concepts#mattermost-connector
+ * @docLink packages/factory-assets/concepts#mattermost-connector
  */
 export declare class MattermostConnector extends AbstractConnector {
     readonly name = "mattermost";
@@ -33,7 +33,7 @@ export declare class MattermostConnector extends AbstractConnector {
 /**
  * Creates a new MattermostConnector instance.
  * @returns Configured MattermostConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#mattermost-connector-factory
+ * @docLink packages/factory-assets/api-reference#mattermost-connector-factory
  */
 export declare function createConnector(): MattermostConnector;
 //# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/mattermost/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;AAUvC;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,KAAK,EAAE,QAAQ,CAAC;;IAahB,cAAc,IAAI,kBAAkB,EAAE;IAiChC,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoCzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ1C,KAAK;YAcL,MAAM;IAapB,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,mBAAmB;YAqGb,UAAU;IA4HxB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;YAQT,OAAO;YAUP,QAAQ;YAeR,OAAO;CActB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,mBAAmB,CAErD"}

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

@@ -0,0 +1,22 @@
+export { MattermostConnector, createConnector15 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=mattermost.js.map
+//# sourceMappingURL=mattermost.js.map

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

@@ -0,0 +1,40 @@
+---
+name: memory
+description: "Ephemeral in-process key-value store — no external deps required"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required: []
+  optional: []
+fields: []
+health_check: null
+keywords:
+  - kv
+  - memory
+  - cache
+  - scratch
+---
+
+A volatile, in-process key-value store backed by a plain `Map`. No external
+dependencies. Data is lost when the session ends. Ideal for scratch state,
+caching within a single run, and testing.
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `get` | read | Get value by key |
+| `set` | write | Set a key-value pair |
+| `keys` | read | List all keys matching a pattern |
+| `del` | write | Delete a key |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: shared-state
+    adapter: memory
+    access: read-write
+    options:
+      namespace: my-app
+```

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

@@ -7,7 +7,7 @@ import { AbstractConnector } from "@skaile/workspaces/connectors";
 /**
  * Connector for an in-process key-value store. Useful for scratch state, agent coordination, and config.
  * No external dependencies — the store lives entirely in process memory and is cleared on disconnect.
- * @docLink packages/base-assets/concepts#memory-connector
+ * @docLink packages/factory-assets/concepts#memory-connector
  */
 export declare class MemoryConnector extends AbstractConnector {
     readonly name = "memory";
@@ -27,7 +27,7 @@ export declare class MemoryConnector extends AbstractConnector {
 /**
  * Creates a new MemoryConnector instance.
  * @returns Configured MemoryConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#memory-connector-factory
+ * @docLink packages/factory-assets/api-reference#memory-connector-factory
  */
 export declare function createConnector(): MemoryConnector;
 //# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/memory/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,QAAQ,EACT,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAOlE;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,QAAQ,CAAC,IAAI,YAAY;IAEzB,KAAK,EAAE,QAAQ,CAAC;;IAeV,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAMzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD,OAAO,CAAC,KAAK;YAIC,KAAK;YAML,MAAM;YAaN,OAAO;YAMP,KAAK;YAgBL,OAAO;IAerB,OAAO,CAAC,mBAAmB;YA8Cb,UAAU;CAmCzB;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAEjD"}

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

@@ -0,0 +1,22 @@
+export { MemoryConnector, createConnector8 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=memory.js.map
+//# sourceMappingURL=memory.js.map

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

@@ -0,0 +1,68 @@
+---
+name: minio
+description: "S3-compatible object storage via MinIO"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required:
+    - minio
+  optional: []
+fields:
+  - key: endpoint
+    label: "MinIO Endpoint"
+    required: true
+    sensitive: false
+  - key: bucket
+    label: "Bucket"
+    required: true
+    sensitive: false
+  - key: access-key
+    label: "Access Key"
+    required: true
+    sensitive: true
+  - key: secret-key
+    label: "Secret Key"
+    required: true
+    sensitive: true
+  - key: region
+    label: "Region"
+    required: false
+    sensitive: false
+  - key: use-ssl
+    label: "Use SSL"
+    required: false
+    sensitive: false
+health_check: list_objects
+keywords:
+  - storage
+  - s3
+  - minio
+  - object-storage
+---
+
+S3-compatible object storage adapter using the MinIO client library. Supports
+listing, reading, writing, and deleting objects, plus pre-signed URL generation.
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `list_objects` | read | List objects in the bucket |
+| `get_object` | read | Download an object |
+| `presign` | read | Generate a pre-signed URL |
+| `put_object` | write | Upload content as an object |
+| `delete_object` | write | Delete an object |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: assets
+    adapter: minio
+    access: read-write
+    options:
+      endpoint: https://minio.example.com
+      bucket: my-bucket
+      access-key: env:MINIO_ACCESS_KEY
+      secret-key: env:MINIO_SECRET_KEY
+```

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

@@ -9,7 +9,7 @@ import type { ConnectContext, ConnectorDeclaration, ConnectorFieldSpec, Connecto
 /**
  * Connector for MinIO and S3-compatible object storage.
  * Provides list, get, put, delete, and presign operations against a single bucket. Requires the `minio` optional peer dependency.
- * @docLink packages/base-assets/concepts#minio-connector
+ * @docLink packages/factory-assets/concepts#minio-connector
  */
 export declare class MinIOConnector extends AbstractConnector {
     readonly name = "minio";
@@ -27,7 +27,7 @@ export declare class MinIOConnector extends AbstractConnector {
 /**
  * Creates a new MinIOConnector instance.
  * @returns Configured MinIOConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#minio-connector-factory
+ * @docLink packages/factory-assets/api-reference#minio-connector-factory
  */
 export declare function createConnector(): MinIOConnector;
 //# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/minio/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,EAEf,QAAQ,EACT,MAAM,+BAA+B,CAAC;AAavC;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,IAAI,WAAW;IAExB,KAAK,EAAE,QAAQ,CAAC;;IAahB,cAAc,IAAI,kBAAkB,EAAE;IAuDtC,OAAO,CAAC,cAAc;IAgBhB,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA0CzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,OAAO,CAAC,mBAAmB;YAwEb,KAAK;YAuBL,KAAK;YAWL,UAAU;CAyCzB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAEhD"}

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

@@ -0,0 +1,22 @@
+export { MinIOConnector, createConnector11 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=minio.js.map
+//# sourceMappingURL=minio.js.map

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

@@ -0,0 +1,46 @@
+---
+name: postgres
+description: "Connect to a PostgreSQL database for structured data access"
+version: "0.1.0"
+entry: ./adapter.ts
+npm_deps:
+  required:
+    - pg
+  optional:
+    - "@types/pg"
+fields:
+  - key: dsn
+    label: "Connection String"
+    required: true
+    sensitive: true
+health_check: query
+keywords:
+  - database
+  - sql
+  - postgresql
+  - relational
+---
+
+A PostgreSQL adapter that wraps the `pg` client library. Supports parameterised
+SQL queries, table listing, row-level read/write, and schema inspection.
+
+Set `auth: env:DATABASE_URL` in `skaile.yaml` to resolve the DSN from an
+environment variable.
+
+## Operations
+
+| Operation | Access | Description |
+|-----------|--------|-------------|
+| `query` | read | Execute a read-only SQL query |
+| `schema` | read | Inspect database schema |
+| `execute` | write | Execute a SQL mutation |
+
+## Configuration
+
+```yaml
+connectors:
+  - id: project-db
+    adapter: postgres
+    access: read-only
+    auth: env:DATABASE_URL
+```

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

@@ -10,7 +10,7 @@ import type { ConnectContext, ConnectorDeclaration, ConnectorFieldSpec, Connecto
 /**
  * Connector for PostgreSQL databases — provides query, schema inspection, and execute operations.
  * Also supports snapshot sync that dumps schema and sample data to JSON files. Requires the `pg` optional peer dependency.
- * @docLink packages/base-assets/concepts#postgres-connector
+ * @docLink packages/factory-assets/concepts#postgres-connector
  */
 export declare class PostgresConnector extends AbstractConnector {
     readonly name = "postgres";
@@ -30,7 +30,7 @@ export declare class PostgresConnector extends AbstractConnector {
 /**
  * Creates a new PostgresConnector instance.
  * @returns Configured PostgresConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#postgres-connector-factory
+ * @docLink packages/factory-assets/api-reference#postgres-connector-factory
  */
 export declare function createConnector(): PostgresConnector;
 //# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/postgres/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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;AAmBvC;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,QAAQ,CAAC,IAAI,cAAc;IAE3B,KAAK,EAAE,QAAQ,CAAC;;IAchB,cAAc,IAAI,kBAAkB,EAAE;IActC,OAAO,CAAC,cAAc;IAoBhB,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAmCzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,OAAO,CAAC,IAAI;YAME,KAAK;YAuBL,KAAK;YA6BL,OAAO;IAwCrB,OAAO,CAAC,mBAAmB;YA2Db,UAAU;CA+DzB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD"}

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

@@ -0,0 +1,22 @@
+export { PostgresConnector, createConnector9 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=postgres.js.map
+//# sourceMappingURL=postgres.js.map

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

@@ -0,0 +1,76 @@
+---
+name: s3
+description: "AWS S3 / S3-compatible object storage connector — syncs objects to a local directory."
+version: "0.1.0"
+entry: ./driver.ts
+fields:
+  - key: auth
+    label: "AWS profile name"
+    required: false
+    sensitive: true
+  - key: options.bucket
+    label: "S3 bucket name"
+    required: true
+    sensitive: false
+  - key: options.prefix
+    label: "Key prefix filter"
+    required: false
+    sensitive: false
+  - key: options.region
+    label: "AWS region"
+    required: false
+    sensitive: false
+  - key: options.endpoint
+    label: "Custom S3-compatible endpoint URL"
+    required: false
+    sensitive: false
+keywords:
+  - s3
+  - aws
+  - bucket
+  - object-storage
+  - minio
+---
+
+## S3 Connector
+
+Downloads all objects from an S3 bucket (or prefix within a bucket) to a local
+directory. Requires `@aws-sdk/client-s3` as an optional peer dependency.
+
+### Configuration
+
+```yaml
+connectors:
+  - id: assets
+    driver: s3
+    access: read-only
+    auth: env:AWS_PROFILE
+    mount:
+      source: my-bucket
+    options:
+      bucket: my-bucket
+      prefix: project/assets/
+      region: eu-central-1
+```
+
+For S3-compatible endpoints (MinIO, DigitalOcean Spaces, etc.):
+
+```yaml
+connectors:
+  - id: minio-data
+    driver: s3
+    access: read-only
+    mount:
+      source: data
+    options:
+      bucket: data
+      endpoint: http://localhost:9000
+      region: us-east-1
+```
+
+### Behavior
+
+- **mount**: Lists all objects under the prefix and downloads them to `targetDir`.
+- **unmount**: Destroys the S3 client.
+- **sync**: Re-downloads all objects (full sync).
+- **watch**: Not implemented (no filesystem watcher — uses base class no-op).

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

@@ -21,7 +21,7 @@ export interface S3SdkModule {
  * Filesystem-face connector for AWS S3 and S3-compatible object storage — downloads all
  * objects from a bucket prefix into a local directory on connect and re-downloads on sync.
  * Requires the `@aws-sdk/client-s3` optional peer dependency.
- * @docLink packages/base-assets/concepts#s3-connector
+ * @docLink packages/factory-assets/concepts#s3-connector
  */
 export declare class S3Connector extends AbstractConnector {
     readonly name = "s3";
@@ -40,7 +40,7 @@ export declare class S3Connector extends AbstractConnector {
  * @param sdkOverride - Optional SDK module to use instead of dynamically importing
  *   `@aws-sdk/client-s3`. Intended for testing only.
  * @returns Configured S3Connector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#s3-connector-factory
+ * @docLink packages/factory-assets/api-reference#s3-connector-factory
  */
 export declare function createConnector(sdkOverride?: S3SdkModule): S3Connector;
 //# sourceMappingURL=driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../factory-assets/connectors/s3/driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,cAAc,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAIlE;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,KACR,MAAM,EAAE,MAAM,KACX;QACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,IAAI,IAAI,CAAC;KACjB,CAAC;IACF,oBAAoB,EAAE,KAAK,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AASD;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,QAAQ,CAAC,IAAI,QAAQ;IAErB,wFAAwF;IACxF,OAAO,CAAC,YAAY,CAAC,CAAc;gBAEvB,WAAW,CAAC,EAAE,WAAW;IAKrC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAIjC;YAEY,QAAQ;IAKhB,OAAO,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDzF,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAM1C,KAAK;YAaL,WAAW;CAuD1B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,WAAW,CAEtE"}

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

@@ -0,0 +1,22 @@
+export { S3Connector, createConnector4 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=s3.js.map
+//# sourceMappingURL=s3.js.map

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

@@ -0,0 +1,181 @@
+---
+name: sharepoint
+description: "SharePoint/OneDrive connector via rclone FUSE."
+version: "0.2.0"
+entry: ./driver.ts
+fields:
+  - key: auth
+    label: "Bearer token or JSON credential bundle"
+    required: true
+    sensitive: true
+  - key: options.driveId
+    label: "Microsoft Graph drive ID"
+    required: true
+    sensitive: false
+  - key: options.folderPath
+    label: "Path to mount within the drive (e.g. /Shared Documents/project)"
+    required: true
+    sensitive: false
+  - key: options.folderId
+    label: "Graph folder item ID (display only — rclone uses folderPath)"
+    required: false
+    sensitive: false
+  - key: options.basePath
+    label: "Subfolder appended under folderPath"
+    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
+  - key: options.ignoreSizeCheck
+    label: "Skip rclone post-transfer size/checksum verification (SharePoint byte-mutation workaround). Default: false"
+    required: false
+    sensitive: false
+keywords:
+  - sharepoint
+  - onedrive
+  - microsoft
+  - graph
+  - office365
+  - rclone
+---
+
+## SharePoint Connector
+
+Exposes a SharePoint or OneDrive folder 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-docs
+    driver: sharepoint
+    access: read-write
+    auth: env:SHAREPOINT_TOKEN
+    mount:
+      source: /Shared Documents/project
+    options:
+      driveId: b!abc123...
+      folderPath: /Shared Documents/project
+      basePath: subfolder/optional
+      cacheMaxSize: 5G
+      cacheMaxAge: 168h
+      vfsWriteBack: 30s
+      ignoreSizeCheck: false   # see "Server-side byte mutation" below
+```
+
+`vfsWriteBack` controls how long a dirty file sits in the VFS cache before
+rclone starts uploading it (rclone's `--vfs-write-back`). The default was raised
+from rclone's old 5s to **30s** to avoid an active-write race: when the agent
+rewrites a file faster than the write-back delay (e.g. a build script
+regenerating an HTML report every few seconds), a short delay lets an upload
+start mid-write, the source grows during transfer, and rclone aborts with
+`corrupted on transfer: sizes differ` and retries indefinitely. Raise it further
+for workloads that rewrite large files in tight loops.
+
+`folderPath` is required: rclone's onedrive backend addresses content by path,
+not by Graph item ID. Provide the full path within the drive (the platform
+typically derives this from the picker selection).
+
+### Authentication
+
+The `auth` field can be:
+- A plain 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,
+    "tenantId": "...",
+    "clientId": "...",
+    "clientSecret": "..."
+  }
+  ```
+
+### Implementation: rclone FUSE
+
+- **mount**: Renders an `[skaile-<id>]` rclone config (onedrive backend, drive
+  ID + OAuth token JSON), 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.
+- **Size/checksum verification**: on by default. `options.ignoreSizeCheck:
+  true` appends `--ignore-size --ignore-checksum` — see "Server-side byte
+  mutation" below.
+- **Cache directory**: `/var/cache/skaile/<mountId>` (the parent
+  `/var/cache/skaile` is bind-mounted from the host per session). The cache
+  root is overridable via the `SKAILE_RCLONE_CACHE_BASE` env var.
+- **write-back**: `--vfs-write-back` defaults to 30s (configurable via
+  `options.vfsWriteBack`) so a rapidly-rewritten file settles before rclone
+  uploads it.
+- **sync**: Calls `RcloneProcessManager.flush`, which first waits for the VFS
+  cache dir to go quiescent (no write within a stability window, bounded by a
+  timeout) so close/hibernate doesn't snapshot a half-written file, then POSTs
+  `/vfs/refresh` and waits for the in-use counter to reach zero.
+- **stuck-upload signal**: if the same object fails to upload 3 times in a row,
+  the connector emits an error-level log (`event: sync_status`, `phase: error`)
+  through the `sharepoint+rclone` subkind so a permanently-failing upload — one
+  that would otherwise retry silently every few minutes forever — is surfaced.
+- **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 `sharepoint+rclone`, alongside the driver's own
+  `sharepoint` entries — both visible via `skaile session logs --kind mount`.
+
+### Server-side byte mutation (`options.ignoreSizeCheck`)
+
+SharePoint Online normalises some text uploads server-side (observed: `*.html`
+having `LF` rewritten to `CRLF`), so the stored object ends up a different byte
+size — and a different checksum — than the local source. rclone's
+post-transfer verification correctly flags this as `corrupted on transfer:
+sizes differ`, deletes the just-uploaded object ("Removing failed copy"), and
+retries indefinitely. The affected file therefore **never durably lands on the
+remote**, so other sessions sharing the same project never see it. Sibling
+`*.md` / `*.mjs` uploads are unaffected because they aren't normalised.
+
+Setting `options.ignoreSizeCheck: true` appends `--ignore-size
+--ignore-checksum` to this mount's `rclone mount` invocation, so rclone accepts
+the upload despite the size/hash drift and the file lands. **This trades
+integrity verification for sync-ability:** a genuinely truncated or corrupted
+upload would no longer be caught for this mount. Leave it `false` unless you
+have confirmed the remote is mutating bytes benignly (e.g. newline
+normalisation) and the alternative is permanently stranded files.
+
+- **Scope:** SharePoint connector only — it is not a global rclone flag and is
+  not exposed by the other rclone-backed connectors.
+- **Off by default:** when unset or `false`, rclone verifies every upload as
+  before.
+
+### Fleet-managed mode (Phase 7B)
+
+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/sharepoint/driver.d.ts

@@ -13,7 +13,7 @@ import { AbstractConnector } from "@skaile/workspaces/connectors";
  * `rclone mount` subprocess via `RcloneProcessManager` using the OneDrive backend.
  * Supports OAuth2 access tokens with optional refresh, and fleet-managed mode via
  * `SKAILE_FLEET_MANAGED_MOUNTS`.
- * @docLink packages/base-assets/concepts#sharepoint-connector
+ * @docLink packages/factory-assets/concepts#sharepoint-connector
  */
 export declare class SharePointConnector extends AbstractConnector {
     readonly name = "sharepoint";
@@ -28,7 +28,7 @@ export declare class SharePointConnector extends AbstractConnector {
 /**
  * Creates a new SharePointConnector instance.
  * @returns Configured SharePointConnector ready to be registered in the connector registry.
- * @docLink packages/base-assets/api-reference#sharepoint-connector-factory
+ * @docLink packages/factory-assets/api-reference#sharepoint-connector-factory
  */
 export declare function createConnector(): SharePointConnector;
 //# sourceMappingURL=driver.d.ts.map