@skaile/workspaces 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.17.0
+
+### Minor Changes
+
+- [#38](https://github.com/skaile-ai/workspaces/pull/38) [`ff8f026`](https://github.com/skaile-ai/workspaces/commit/ff8f0262b142420bb2601225e99b059c8ab2edaf) Thanks [@Frozen666](https://github.com/Frozen666)! - Add `session.fromRef` option to the git mount driver so a freshly-created session branch can be anchored at an arbitrary ref instead of always branching from the cloned base branch.
+
+  When the session branch does not yet exist on origin and `fromRef` is set, the driver runs `git fetch origin <fromRef>` followed by `git checkout -b <sessionBranch> FETCH_HEAD`. If the fetch fails (ref doesn't exist on the remote), the driver logs a warning and falls back to the previous behavior (branch from base). When the session branch already exists on origin, `fromRef` is ignored — existing branches win.
+
+  Consumed by the platform's session-fork flow: forks now pass `fromRef = "skaile/session-<source-slug>"` so the fork branches off the source's tip rather than off `main`. Closes the runtime half of platform B-103.
+
 ## 0.16.0
 
 ### Minor Changes

package/dist/asset-manager/index.js

@@ -1,4 +1,4 @@
-export { AssetManager } from '../chunk-YMMWP3YL.js';
+export { AssetManager } from '../chunk-DG7WFRUM.js';
 export { createScaffold, deployAll, installAgent, removeAsset } from '../chunk-42YLNYFK.js';
 import '../chunk-4BRSVK7Q.js';
 import '../chunk-JKNWJ64A.js';

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

@@ -1,4 +1,4 @@
-export { DeployConnector, createConnector21 as createConnector } from '../../chunk-YW36VEVN.js';
+export { DeployConnector, createConnector21 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { DevServerConnector, createConnector18 as createConnector } from '../../chunk-YW36VEVN.js';
+export { DevServerConnector, createConnector18 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { FlowAdapter, createConnector } from '../../../chunk-YW36VEVN.js';
+export { FlowAdapter, createConnector } from '../../../chunk-6SCFOXJ5.js';
 import '../../../chunk-KJ2LLWRF.js';
 import '../../../chunk-6MB7CRME.js';
 import '../../../chunk-QAVZOJCV.js';

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

@@ -1,7 +1,7 @@
-export { resumeFlow, runFlow } from '../../../chunk-ALJM24WL.js';
+export { resumeFlow, runFlow } from '../../../chunk-PXABRXBP.js';
 import '../../../chunk-GCJXPUHG.js';
 import '../../../chunk-IPUYL6TD.js';
-import '../../../chunk-YW36VEVN.js';
+import '../../../chunk-6SCFOXJ5.js';
 import '../../../chunk-KJ2LLWRF.js';
 import '../../../chunk-6MB7CRME.js';
 import '../../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/flow.js

@@ -1,4 +1,4 @@
-export { FlowAdapter, createConnector } from '../../chunk-YW36VEVN.js';
+export { FlowAdapter, createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../base-assets/connectors/git/driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,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;AA0KlE;;;;;;;;;;;;;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;IAyI/F;;;;;;;;;;;;;;;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;YAc1C,KAAK;IAeV,KAAK,CACZ,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC/C,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW;IA0BC,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAwBjE,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiDnF;;;;;;;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;IAyB3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,4BAA4B;IAkCpC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,kBAAkB;IAwB1B;;;;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"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../base-assets/connectors/git/driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,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;AA2MlE;;;;;;;;;;;;;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;IAuK/F;;;;;;;;;;;;;;;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;YAc1C,KAAK;IAeV,KAAK,CACZ,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC/C,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW;IA0BC,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAwBjE,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiDnF;;;;;;;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;IAyB3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,4BAA4B;IAkCpC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,kBAAkB;IAwB1B;;;;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/base-assets/connectors/git.js

@@ -1,4 +1,4 @@
-export { GitConnector, createConnector2 as createConnector } from '../../chunk-YW36VEVN.js';
+export { GitConnector, createConnector2 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { GmailConnector, createConnector16 as createConnector } from '../../chunk-YW36VEVN.js';
+export { GmailConnector, createConnector16 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { GoogleDriveConnector, createConnector7 as createConnector, parseAuthBlob } from '../../chunk-YW36VEVN.js';
+export { GoogleDriveConnector, createConnector7 as createConnector, parseAuthBlob } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { LocalConnector, createConnector3 as createConnector } from '../../chunk-YW36VEVN.js';
+export { LocalConnector, createConnector3 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { MattermostConnector, createConnector17 as createConnector } from '../../chunk-YW36VEVN.js';
+export { MattermostConnector, createConnector17 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { MemoryConnector, createConnector8 as createConnector } from '../../chunk-YW36VEVN.js';
+export { MemoryConnector, createConnector8 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { MinIOConnector, createConnector12 as createConnector } from '../../chunk-YW36VEVN.js';
+export { MinIOConnector, createConnector12 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { PostgresConnector, createConnector9 as createConnector } from '../../chunk-YW36VEVN.js';
+export { PostgresConnector, createConnector9 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/redis.js

@@ -1,4 +1,4 @@
-export { RedisConnector, createConnector10 as createConnector } from '../../chunk-YW36VEVN.js';
+export { RedisConnector, createConnector10 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

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

@@ -1,4 +1,4 @@
-export { S3Connector, createConnector4 as createConnector } from '../../chunk-YW36VEVN.js';
+export { S3Connector, createConnector4 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/sharepoint.js

@@ -1,4 +1,4 @@
-export { SharePointConnector, createConnector6 as createConnector } from '../../chunk-YW36VEVN.js';
+export { SharePointConnector, createConnector6 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/sqlite.js

@@ -1,4 +1,4 @@
-export { SQLiteConnector, createConnector11 as createConnector } from '../../chunk-YW36VEVN.js';
+export { SQLiteConnector, createConnector11 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/static-server.js

@@ -1,4 +1,4 @@
-export { StaticServerConnector, createConnector19 as createConnector } from '../../chunk-YW36VEVN.js';
+export { StaticServerConnector, createConnector19 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/tunnel.js

@@ -1,4 +1,4 @@
-export { TunnelConnector, createConnector20 as createConnector } from '../../chunk-YW36VEVN.js';
+export { TunnelConnector, createConnector20 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/webdav.js

@@ -1,4 +1,4 @@
-export { WebDAVConnector, createConnector5 as createConnector } from '../../chunk-YW36VEVN.js';
+export { WebDAVConnector, createConnector5 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/xstate-store.js

@@ -1,4 +1,4 @@
-export { XStateStoreConnector, createConnector14 as createConnector } from '../../chunk-YW36VEVN.js';
+export { XStateStoreConnector, createConnector14 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/xstate.js

@@ -1,4 +1,4 @@
-export { XStateConnector, createConnector13 as createConnector } from '../../chunk-YW36VEVN.js';
+export { XStateConnector, createConnector13 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/base-assets/connectors/yjs.js

@@ -1,4 +1,4 @@
-export { YjsConnector, createConnector15 as createConnector } from '../../chunk-YW36VEVN.js';
+export { YjsConnector, createConnector15 as createConnector } from '../../chunk-6SCFOXJ5.js';
 import '../../chunk-KJ2LLWRF.js';
 import '../../chunk-6MB7CRME.js';
 import '../../chunk-QAVZOJCV.js';

package/dist/{chunk-YW36VEVN.js → chunk-6SCFOXJ5.js}

@@ -58,7 +58,8 @@ function parseSessionConfig(opts) {
     enabled: Boolean(raw.enabled ?? false),
     slug: raw.slug != null ? String(raw.slug) : void 0,
     isMain: Boolean(raw.isMain ?? true),
-    branchPrefix: String(raw.branchPrefix ?? "session/")
+    branchPrefix: String(raw.branchPrefix ?? "session/"),
+    fromRef: raw.fromRef != null ? String(raw.fromRef) : void 0
   };
 }
 function parseSyncConfig(opts) {
@@ -83,6 +84,13 @@ function parseLifecycleConfig(opts) {
 function git(cmd, cwd, timeout = 3e4) {
   return execSync(`git ${cmd}`, { cwd, encoding: "utf-8", timeout, stdio: "pipe" }).trim();
 }
+function isValidGitRefOrSha(ref) {
+  if (ref.length === 0 || ref.length > 255) return false;
+  if (/[\s\\~^:?*[\x00-\x1f\x7f`$;&|'"<>()]/.test(ref)) return false;
+  if (ref.startsWith("-") || ref.endsWith(".lock") || ref.endsWith("/") || ref.endsWith(".")) return false;
+  if (ref.includes("..") || ref.includes("@{")) return false;
+  return true;
+}
 function hasChanges(cwd) {
   const status = git("status --porcelain", cwd);
   return status.length > 0;
@@ -179,7 +187,31 @@ var GitConnector = class extends AbstractConnector {
         git(`rev-parse --verify origin/${sessionBranch}`, targetDir);
         git(`checkout -B ${sessionBranch} origin/${sessionBranch}`, targetDir);
       } catch {
-        git(`checkout -b ${sessionBranch}`, targetDir);
+        let anchored = false;
+        if (session.fromRef) {
+          if (!isValidGitRefOrSha(session.fromRef)) {
+            this.log.warn("fromRef rejected by refname validation, falling back to base branch", {
+              sessionBranch,
+              fromRef: session.fromRef
+            });
+          } else {
+            try {
+              git(`fetch origin ${session.fromRef}`, targetDir);
+              git(`checkout -b ${sessionBranch} FETCH_HEAD`, targetDir);
+              anchored = true;
+              this.log.info("session branch created from fromRef", { sessionBranch, fromRef: session.fromRef });
+            } catch (err) {
+              this.log.warn("fromRef fetch failed, falling back to base branch", {
+                sessionBranch,
+                fromRef: session.fromRef,
+                error: err instanceof Error ? err.message : String(err)
+              });
+            }
+          }
+        }
+        if (!anchored) {
+          git(`checkout -b ${sessionBranch}`, targetDir);
+        }
       }
       state.activeBranch = sessionBranch;
       this.log.info("session branch checked out", { sessionBranch });
@@ -7882,5 +7914,5 @@ function createConnector() {
 }
 
 export { AbstractConnector, ConnectorFieldMissingError, ConnectorManager, ConnectorStartupError, DeployConnector, DevServerConnector, FlowAdapter, GitConnector, GmailConnector, GoogleDriveConnector, LocalConnector, LogBuffer, ManagedGitconfigCollisionError, MattermostConnector, MemoryConnector, MinIOConnector, PostgresConnector, RedisConnector, S3Connector, SQLiteConnector, SharePointConnector, StaticServerConnector, TunnelConnector, WebDAVConnector, XStateConnector, XStateStoreConnector, YjsConnector, atomicReplaceCredential, buildConnectorPromptSection, buildSdkConnectorTools, createConnector, createConnector10, createConnector11, createConnector12, createConnector13, createConnector14, createConnector15, createConnector16, createConnector17, createConnector18, createConnector19, createConnector2, createConnector20, createConnector21, createConnector3, createConnector4, createConnector5, createConnector6, createConnector7, createConnector8, createConnector9, createFsWatcher, createWorktree, defaultSpawn, ensureFleetMounted, findGitRoot, findMissingPackages, getConnector, installNpmPackages, isFleetManaged, isPackageResolvable, listConnectors, listWorktrees, parseAuthBlob2 as parseAuthBlob, registerBuiltinConnectors, registerConnector, removeMountBlock, renderCredentialHelperScript, tryGetConnector, worktreeRegistry, writeHelperScript, writeMountBlock };
-//# sourceMappingURL=chunk-YW36VEVN.js.map
-//# sourceMappingURL=chunk-YW36VEVN.js.map
+//# sourceMappingURL=chunk-6SCFOXJ5.js.map
+//# sourceMappingURL=chunk-6SCFOXJ5.js.map