@skaile/workspaces 4.5.2 → 4.6.0

package/dist/chunk-SDNGG6FB.js

@@ -0,0 +1,32 @@
+import { CONNECTOR_ERROR_KINDS } from './chunk-QAH24E5U.js';
+
+// connectors/src/connect-error-kind.ts
+var CONNECT_ERROR_KIND_PROPERTY = "skaileConnectErrorKind";
+function declaredConnectErrorKind(err) {
+  if (err === null || typeof err !== "object" || !(CONNECT_ERROR_KIND_PROPERTY in err)) {
+    return void 0;
+  }
+  const value = err[CONNECT_ERROR_KIND_PROPERTY];
+  return CONNECTOR_ERROR_KINDS.includes(value) ? value : void 0;
+}
+function withConnectErrorKind(err, kind) {
+  if (err !== null && typeof err === "object" && !(CONNECT_ERROR_KIND_PROPERTY in err)) {
+    try {
+      err[CONNECT_ERROR_KIND_PROPERTY] = kind;
+    } catch {
+    }
+  }
+  return err;
+}
+var ClassifiedConnectError = class extends Error {
+  [CONNECT_ERROR_KIND_PROPERTY];
+  constructor(message, kind) {
+    super(message);
+    this.name = "ClassifiedConnectError";
+    this[CONNECT_ERROR_KIND_PROPERTY] = kind;
+  }
+};
+
+export { CONNECT_ERROR_KIND_PROPERTY, ClassifiedConnectError, declaredConnectErrorKind, withConnectErrorKind };
+//# sourceMappingURL=chunk-SDNGG6FB.js.map
+//# sourceMappingURL=chunk-SDNGG6FB.js.map

package/dist/chunk-SDNGG6FB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../connectors/src/connect-error-kind.ts"],"names":[],"mappings":";;;AAuBO,IAAM,2BAAA,GAA8B;AAYpC,SAAS,yBAAyB,GAAA,EAA8C;AACrF,EAAA,IAAI,QAAQ,IAAA,IAAQ,OAAO,QAAQ,QAAA,IAAY,EAAE,+BAA+B,GAAA,CAAA,EAAM;AACpF,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,GAAS,IAAgC,2BAA2B,CAAA;AAC1E,EAAA,OAAQ,qBAAA,CAA6C,QAAA,CAAS,KAAK,CAAA,GAC9D,KAAA,GACD,MAAA;AACN;AAOO,SAAS,oBAAA,CAAwB,KAAQ,IAAA,EAA6B;AAC3E,EAAA,IAAI,QAAQ,IAAA,IAAQ,OAAO,QAAQ,QAAA,IAAY,EAAE,+BAA+B,GAAA,CAAA,EAAM;AACpF,IAAA,IAAI;AACF,MAAC,GAAA,CAAgC,2BAA2B,CAAA,GAAI,IAAA;AAAA,IAClE,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;AAMO,IAAM,sBAAA,GAAN,cAAqC,KAAA,CAAM;AAAA,EAChD,CAAU,2BAA2B;AAAA,EACrC,WAAA,CAAY,SAAiB,IAAA,EAA0B;AACrD,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,wBAAA;AACZ,IAAA,IAAA,CAAK,2BAA2B,CAAA,GAAI,IAAA;AAAA,EACtC;AACF","file":"chunk-SDNGG6FB.js","sourcesContent":["/**\n * The driver-side contract for classifying a connect failure: how a thrower\n * says which {@link ConnectorErrorKind} its error is. Read by the manager's\n * `classifyConnectError` (`classify-connect-error.ts`) into the `errorKind`\n * field of `connector_status` error events.\n *\n * Depends on nothing but `types`, so the `connectors-shared` subpath can\n * re-export it to out-of-tree drivers.\n *\n * @docLink packages/connectors/concepts#connector-manager\n */\n\nimport { CONNECTOR_ERROR_KINDS, type ConnectorErrorKind } from \"@skaile/workspaces/types\";\n\n/**\n * The property a thrown error carries its kind on.\n *\n * Namespaced because it is read off any thrown object: a bare `errorKind` is\n * a name a library's own error may already use, and a value that happened to\n * read `\"config\"` would silently misroute the failure. A plain string key\n * rather than a symbol, so a driver with no import from this package can still\n * set it: `throw Object.assign(new Error(msg), { skaileConnectErrorKind: \"config\" })`.\n */\nexport const CONNECT_ERROR_KIND_PROPERTY = \"skaileConnectErrorKind\";\n\n/**\n * The shape of an error that declares its kind. For classes that must spell the\n * key out instead of computing it (see the git driver's `TokenMediatorError`):\n * `implements` keeps the literal tied to {@link CONNECT_ERROR_KIND_PROPERTY}.\n */\nexport type DeclaresConnectErrorKind = {\n  readonly [CONNECT_ERROR_KIND_PROPERTY]: ConnectorErrorKind;\n};\n\n/** The kind `err` declares for itself, or `undefined` when it declares none (or an unknown one). */\nexport function declaredConnectErrorKind(err: unknown): ConnectorErrorKind | undefined {\n  if (err === null || typeof err !== \"object\" || !(CONNECT_ERROR_KIND_PROPERTY in err)) {\n    return undefined;\n  }\n  const value = (err as Record<string, unknown>)[CONNECT_ERROR_KIND_PROPERTY];\n  return (CONNECTOR_ERROR_KINDS as readonly unknown[]).includes(value)\n    ? (value as ConnectorErrorKind)\n    : undefined;\n}\n\n/**\n * Stamp `kind` onto `err` unless it already declares one, and return it for\n * rethrowing. For throw sites that know what a failure means but throw an\n * error they did not construct (a failed `git` child, say).\n */\nexport function withConnectErrorKind<T>(err: T, kind: ConnectorErrorKind): T {\n  if (err !== null && typeof err === \"object\" && !(CONNECT_ERROR_KIND_PROPERTY in err)) {\n    try {\n      (err as Record<string, unknown>)[CONNECT_ERROR_KIND_PROPERTY] = kind;\n    } catch {\n      // Frozen or sealed: unclassified beats replacing the real error with a TypeError.\n    }\n  }\n  return err;\n}\n\n/**\n * An `Error` carrying an explicit {@link ConnectorErrorKind}, for throw sites\n * that build their own error.\n */\nexport class ClassifiedConnectError extends Error {\n  readonly [CONNECT_ERROR_KIND_PROPERTY]: ConnectorErrorKind;\n  constructor(message: string, kind: ConnectorErrorKind) {\n    super(message);\n    this.name = \"ClassifiedConnectError\";\n    this[CONNECT_ERROR_KIND_PROPERTY] = kind;\n  }\n}\n"]}

package/dist/{chunk-Y5E6LHSQ.js → chunk-TRGMQUAZ.js}

@@ -1,7 +1,8 @@
-import { resolveAuthRef } from './chunk-KW7YIRYL.js';
-import { EventNormalizer } from './chunk-GVOPQBGM.js';
-import { resolveModelTier } from './chunk-VP2CACF2.js';
-import { createDriver } from './chunk-C2CYBRYJ.js';
+import { declaredConnectErrorKind, ClassifiedConnectError, withConnectErrorKind } from './chunk-SDNGG6FB.js';
+import { OAuthRequiredError, LegacyAuthGrammarError, resolveAuthRef } from './chunk-KW7YIRYL.js';
+import { EventNormalizer } from './chunk-V7SHQXDI.js';
+import { resolveModelTier } from './chunk-QVTROHEZ.js';
+import { createDriver } from './chunk-KMFZVPYR.js';
 import { pluginRegistry } from './chunk-6E6PKKAD.js';
 import { computeStimulus } from './chunk-IFGTRL2I.js';
 import { interpolateNodeInstruction, resolveNodeBindings, getConsumedOutputSchema, validateConsumedNodeOutput, appendAttempt, resolveTerminalFailureStatus, remainingActiveExecutionMs, deriveCheckEvidence, computeFlowStateFromSnapshots, availableRouterFrontier, evaluateRouterSelection, routerSelectionOutput, planRouterSkips, unsettledRouterBranchIds, countFailedAttempts, hasAutomaticRetryBudget, persistedRouterSelection } from './chunk-NWZQMJTI.js';
@@ -9,7 +10,7 @@ import { INPUT_SCHEMA_SHAPES_HINT, coerceInputSchema } from './chunk-TIOT3ZOQ.js
 import { classifierDecision, withoutReservedClassifierFields, parseFlowDefinition } from './chunk-53ORCYPJ.js';
 import { describeStimulus, buildOrchestratorPrompt, renderSubpromptPrompt, renderStimulusPrompt } from './chunk-2D5BYAL6.js';
 import { deterministicNodeKindLabel, nodeInstruction, flowDefaults, isAgentNode, isGateNode, isCheckNode, nodeRequiresApproval, isSubFlowNode, isFunctionNode, isSubpromptNode, isRouterNode, isActiveRuntimeNode, nodeIsOptional, nodeLabel, nodeAssets } from './chunk-ELPR5XBG.js';
-import { withActivityLabelDefs } from './chunk-U4AA7MOV.js';
+import { withActivityLabelDefs } from './chunk-QAH24E5U.js';
 import { processAlive } from './chunk-UJPVUN6H.js';
 import { withFsDeadline, tryWithFsDeadline, FsDeadlineError, fsDeadlineMs } from './chunk-MKZOK4JU.js';
 import { portableSpawn } from './chunk-KSIRR5PL.js';
@@ -734,6 +735,44 @@ function runIsolatedPrompt(driver, prompt) {
     driver.prompt(prompt).catch(done);
   });
 }
+
+// connectors/src/connector-types.ts
+var ConnectorFieldMissingError = class extends Error {
+  connectorId;
+  field;
+  triedRef;
+  availableProviders;
+  constructor(opts) {
+    super(
+      `Connector "${opts.connectorId}" is missing required field "${opts.field.key}" (tried: ${opts.triedRef || "(none)"}). Available providers: ${opts.availableProviders.join(", ") || "(none)"}`
+    );
+    this.name = "ConnectorFieldMissingError";
+    this.connectorId = opts.connectorId;
+    this.field = opts.field;
+    this.triedRef = opts.triedRef;
+    this.availableProviders = opts.availableProviders;
+  }
+};
+var ConnectorStartupError = class extends Error {
+  report;
+  failedReadWrite;
+  constructor(message, report, failedReadWrite) {
+    super(message);
+    this.name = "ConnectorStartupError";
+    this.report = report;
+    this.failedReadWrite = failedReadWrite;
+  }
+};
+
+// connectors/src/classify-connect-error.ts
+function classifyConnectError(err) {
+  const declared = declaredConnectErrorKind(err);
+  if (declared) return declared;
+  if (err instanceof OAuthRequiredError) return "credential";
+  if (err instanceof ConnectorFieldMissingError) return "config";
+  if (err instanceof LegacyAuthGrammarError) return "config";
+  return void 0;
+}
 var execFileAsync = promisify(execFile);
 var GIT_REV_PARSE_TIMEOUT_MS = 15e3;
 var DeployConnector = class extends AbstractConnector {
@@ -1663,6 +1702,15 @@ async function clearStaleIndexLock(targetDir, log) {
     log.warn("removed an abandoned .git/index.lock", { lockPath, ageMs });
   }
 }
+function isIndexLockFailure(err) {
+  const stderr = err?.stderr;
+  return typeof stderr === "string" && /index\.lock/.test(stderr);
+}
+function gitLocalCheckout(args, cwd) {
+  return git(["checkout", ...args], cwd).catch((err) => {
+    throw typeof err?.code === "number" ? withConnectErrorKind(err, "repo-state") : err;
+  });
+}
 async function syncSubmodules(cwd, log) {
   if (!await pathExists(join(cwd, ".gitmodules"))) return;
   try {
@@ -1743,6 +1791,8 @@ async function commitAll(cwd, message) {
   return gitCommitting(["commit", "-m", message], cwd);
 }
 var TokenMediatorError = class extends Error {
+  /** Every mediator refusal is fixed where the credential lives, whatever its code. */
+  skaileConnectErrorKind = "credential";
   code;
   constructor(message, code, connectorId) {
     super(`Git connector '${connectorId}': backend mediator ${code} \u2014 ${message}`);
@@ -1804,10 +1854,10 @@ var GitConnector = class extends AbstractConnector {
     let credentialAlignmentAttempted = false;
     if (!url) {
       this.log.error("connect failed: missing mount.source URL", void 0);
-      throw new Error("Git connector requires a mount.source URL");
+      throw new ClassifiedConnectError("Git connector requires a mount.source URL", "config");
     }
     if (!isValidGitRefOrSha(branch)) {
-      throw new Error(`Git connector: invalid branch name "${branch}"`);
+      throw new ClassifiedConnectError(`Git connector: invalid branch name "${branch}"`, "config");
     }
     try {
       this.log.info("mount start", { url, branch, targetDir });
@@ -1888,6 +1938,7 @@ var GitConnector = class extends AbstractConnector {
         }
       }
       this.registerUnavailableCredentialHelper(declaration, credentialScopeUrl, err);
+      if (isIndexLockFailure(err)) withConnectErrorKind(err, "repo-state");
       throw err;
     }
   }
@@ -1976,11 +2027,14 @@ var GitConnector = class extends AbstractConnector {
   async checkoutSessionBranch(state, session, targetDir) {
     const sessionBranch = `${session.branchPrefix}${session.slug}`;
     if (!isValidGitRefOrSha(sessionBranch)) {
-      throw new Error(`Git connector: invalid session branch name "${sessionBranch}"`);
+      throw new ClassifiedConnectError(
+        `Git connector: invalid session branch name "${sessionBranch}"`,
+        "config"
+      );
     }
     let created = false;
     if (await localBranchExists(sessionBranch, targetDir)) {
-      await git(["checkout", sessionBranch], targetDir);
+      await gitLocalCheckout([sessionBranch], targetDir);
       this.log.info("reusing existing local session branch", { sessionBranch });
     } else {
       let originHasBranch = false;
@@ -1990,9 +2044,9 @@ var GitConnector = class extends AbstractConnector {
       } catch {
       }
       if (originHasBranch) {
-        await git(["checkout", "-B", sessionBranch, `origin/${sessionBranch}`], targetDir);
+        await gitLocalCheckout(["-B", sessionBranch, `origin/${sessionBranch}`], targetDir);
       } else if (!await this.branchFromRef(session, sessionBranch, targetDir)) {
-        await git(["checkout", "-b", sessionBranch], targetDir);
+        await gitLocalCheckout(["-b", sessionBranch], targetDir);
         created = true;
       } else {
         created = true;
@@ -2312,8 +2366,9 @@ var GitConnector = class extends AbstractConnector {
     }
     if (authRef.kind === "backend") {
       if (!tokenMediator) {
-        throw new Error(
-          `Connector '${declaration.id}' uses 'auth: backend' but no token mediator is wired (standalone CLI does not have one \u2014 use 'pat:env:NAME' instead).`
+        throw new ClassifiedConnectError(
+          `Connector '${declaration.id}' uses 'auth: backend' but no token mediator is wired (standalone CLI does not have one \u2014 use 'pat:env:NAME' instead).`,
+          "config"
         );
       }
       const result = await tokenMediator({ connectorId: declaration.id, reason: "initial" });
@@ -2342,8 +2397,9 @@ var GitConnector = class extends AbstractConnector {
       token = inner;
     }
     if (!token) {
-      throw new Error(
-        `PAT auth ref '${authRef.raw}' did not resolve to a token. Provision '${authRef.value}' in the SecretProviderChain.`
+      throw new ClassifiedConnectError(
+        `PAT auth ref '${authRef.raw}' did not resolve to a token. Provision '${authRef.value}' in the SecretProviderChain.`,
+        "credential"
       );
     }
     return { authRef, token, expiresAt: null };
@@ -6261,34 +6317,6 @@ function ensureBuiltinsRegistered() {
   }
 }
 
-// connectors/src/connector-types.ts
-var ConnectorFieldMissingError = class extends Error {
-  connectorId;
-  field;
-  triedRef;
-  availableProviders;
-  constructor(opts) {
-    super(
-      `Connector "${opts.connectorId}" is missing required field "${opts.field.key}" (tried: ${opts.triedRef || "(none)"}). Available providers: ${opts.availableProviders.join(", ") || "(none)"}`
-    );
-    this.name = "ConnectorFieldMissingError";
-    this.connectorId = opts.connectorId;
-    this.field = opts.field;
-    this.triedRef = opts.triedRef;
-    this.availableProviders = opts.availableProviders;
-  }
-};
-var ConnectorStartupError = class extends Error {
-  report;
-  failedReadWrite;
-  constructor(message, report, failedReadWrite) {
-    super(message);
-    this.name = "ConnectorStartupError";
-    this.report = report;
-    this.failedReadWrite = failedReadWrite;
-  }
-};
-
 // connectors/src/connector-manager.ts
 var KNOWN_PREFIXES = ["env:", "forge:", "op:", "kp:", "oauth:"];
 function hasKnownPrefix(ref) {
@@ -6491,16 +6519,18 @@ var ConnectorManager = class {
     if (registered) return registered;
     const entry = this.catalogEntries.find((e) => e.kind === "connector" && e.name === driver);
     if (!entry) {
-      throw new Error(
-        `Unknown connector: "${driver}". Run 'skaile search connector' to see available connectors.`
+      throw new ClassifiedConnectError(
+        `Unknown connector: "${driver}". Run 'skaile search connector' to see available connectors.`,
+        "config"
       );
     }
     const entryPoint = entry.metadata?.entry ?? "./connector.ts";
     const connectorPath = resolve(dirname(entry.source), entryPoint);
     const mod = await import(connectorPath);
     if (typeof mod.createConnector !== "function") {
-      throw new Error(
-        `Connector "${driver}" at ${connectorPath} does not export createConnector()`
+      throw new ClassifiedConnectError(
+        `Connector "${driver}" at ${connectorPath} does not export createConnector()`,
+        "config"
       );
     }
     const connector = mod.createConnector();
@@ -6535,8 +6565,9 @@ var ConnectorManager = class {
     const owner = this.mountTargets.get(absPath);
     if (owner === id) return;
     if (owner !== void 0) {
-      throw new Error(
-        `Mount target collision: connectors "${owner}" and "${id}" both resolve to "${absPath}". Each filesystem connector needs a distinct mount.target.`
+      throw new ClassifiedConnectError(
+        `Mount target collision: connectors "${owner}" and "${id}" both resolve to "${absPath}". Each filesystem connector needs a distinct mount.target.`,
+        "config"
       );
     }
     for (const [otherPath, otherId] of this.mountTargets) {
@@ -6744,12 +6775,18 @@ var ConnectorManager = class {
       if (!this.active.has(decl.id)) this.releaseMountTarget(decl.id);
       const msg = err instanceof Error ? err.message : String(err);
       this.recordFailure(decl, msg);
-      this.mgrLog.error("connect failed", err, { id: decl.id, driver: decl.driver });
+      const errorKind = classifyConnectError(err);
+      this.mgrLog.error("connect failed", err, {
+        id: decl.id,
+        driver: decl.driver,
+        ...errorKind ? { errorKind } : {}
+      });
       this.opts.onStatusChange?.({
         type: "connector_status",
         connectorId: decl.id,
         status: "error",
-        error: msg
+        error: msg,
+        ...errorKind ? { errorKind } : {}
       });
       return {
         id: decl.id,
@@ -6834,11 +6871,13 @@ var ConnectorManager = class {
       this.releaseMountTarget(declaration.id);
       const msg = err instanceof Error ? err.message : String(err);
       this.recordFailure(declaration, msg);
+      const errorKind = classifyConnectError(err);
       this.opts.onStatusChange?.({
         type: "connector_status",
         connectorId: declaration.id,
         status: "error",
-        error: msg
+        error: msg,
+        ...errorKind ? { errorKind } : {}
       });
       throw err;
     }
@@ -11081,6 +11120,6 @@ function describeFlowOperations() {
   return new FlowAdapter().tools.describeOperations({ access: "read-write" });
 }
 
-export { AbstractConnector, BUILTIN_CONNECTOR_CATALOG, BoxConnector, ClassifierSubpromptRunner, ConnectorFieldMissingError, ConnectorManager, ConnectorStartupError, DeployConnector, DevServerConnector, FlowAdapter, GitConnector, GmailConnector, GoogleDriveConnector, LocalConnector, LogBuffer, MAX_REARM_MS, MIN_REFRESH_DELAY_MS, ManagedGitconfigCollisionError, MattermostConnector, MemoryConnector, MinIOConnector, NO_ACTIVE_FLOW_ERROR, PortPool, PostgresConnector, REFRESH_LEAD_MS, S3Connector, SQLiteConnector, SessionInlineSubFlowRunner, SessionNodeExecutor, SessionSubpromptRunner, SharePointConnector, StaticServerConnector, TunnelConnector, WebDAVConnector, XStateConnector, XStateStoreConnector, __test, atomicReplaceCredential, buildConnectorPromptSection, buildConnectorToolDefs, buildFlowPromptEvent, buildFlowToolDefs, buildLazyFlowToolDefs, buildLazySdkFlowTools, buildSdkConnectorTools, buildSdkFlowTools, classifierQuestion, createConnector, createConnector10, createConnector11, createConnector12, createConnector13, createConnector14, createConnector15, createConnector16, createConnector17, createConnector18, createConnector19, createConnector2, createConnector20, createConnector3, createConnector4, createConnector5, createConnector6, createConnector7, createConnector8, createConnector9, createFsWatcher, createWorktree, defaultSpawn, describeFlowOperations, driveOrchestratorTurn, ensureDirMode, ensureFleetMounted, ensureRefreshAttemptStamp, findGitRoot, findMissingPackages, getConnector, installNpmPackages, isFleetManaged, isPackageResolvable, listConnectors, listWorktrees, readGitSyncStatus, registerBuiltinConnectors, removeMountBlock, removeUnavailableMountBlock, renderCredentialHelperScript, tryGetConnector, worktreeRegistry, writeHelperScript, writeMountBlock, writeUnavailableMountBlock };
-//# sourceMappingURL=chunk-Y5E6LHSQ.js.map
-//# sourceMappingURL=chunk-Y5E6LHSQ.js.map
+export { AbstractConnector, BUILTIN_CONNECTOR_CATALOG, BoxConnector, ClassifierSubpromptRunner, ConnectorFieldMissingError, ConnectorManager, ConnectorStartupError, DeployConnector, DevServerConnector, FlowAdapter, GitConnector, GmailConnector, GoogleDriveConnector, LocalConnector, LogBuffer, MAX_REARM_MS, MIN_REFRESH_DELAY_MS, ManagedGitconfigCollisionError, MattermostConnector, MemoryConnector, MinIOConnector, NO_ACTIVE_FLOW_ERROR, PortPool, PostgresConnector, REFRESH_LEAD_MS, S3Connector, SQLiteConnector, SessionInlineSubFlowRunner, SessionNodeExecutor, SessionSubpromptRunner, SharePointConnector, StaticServerConnector, TunnelConnector, WebDAVConnector, XStateConnector, XStateStoreConnector, __test, atomicReplaceCredential, buildConnectorPromptSection, buildConnectorToolDefs, buildFlowPromptEvent, buildFlowToolDefs, buildLazyFlowToolDefs, buildLazySdkFlowTools, buildSdkConnectorTools, buildSdkFlowTools, classifierQuestion, classifyConnectError, createConnector, createConnector10, createConnector11, createConnector12, createConnector13, createConnector14, createConnector15, createConnector16, createConnector17, createConnector18, createConnector19, createConnector2, createConnector20, createConnector3, createConnector4, createConnector5, createConnector6, createConnector7, createConnector8, createConnector9, createFsWatcher, createWorktree, defaultSpawn, describeFlowOperations, driveOrchestratorTurn, ensureDirMode, ensureFleetMounted, ensureRefreshAttemptStamp, findGitRoot, findMissingPackages, getConnector, installNpmPackages, isFleetManaged, isPackageResolvable, listConnectors, listWorktrees, readGitSyncStatus, registerBuiltinConnectors, removeMountBlock, removeUnavailableMountBlock, renderCredentialHelperScript, tryGetConnector, worktreeRegistry, writeHelperScript, writeMountBlock, writeUnavailableMountBlock };
+//# sourceMappingURL=chunk-TRGMQUAZ.js.map
+//# sourceMappingURL=chunk-TRGMQUAZ.js.map