@databricks/appkit 0.59.0 → 0.61.0

package/dist/cli/commands/registry/server-register.js

@@ -0,0 +1,124 @@
+import { JS_IDENTIFIER } from "./constants.js";
+import fs from "node:fs";
+import path from "node:path";
+import { Lang, parse } from "@ast-grep/napi";
+
+//#region src/cli/commands/registry/server-register.ts
+/** Server entry candidates within the server root, in priority order. */
+const SERVER_FILE_CANDIDATES = [
+	"server.ts",
+	"index.ts",
+	"src/server.ts",
+	"src/index.ts"
+];
+function findServerFile(serverRoot) {
+	for (const candidate of SERVER_FILE_CANDIDATES) {
+		const p = path.join(serverRoot, candidate);
+		if (fs.existsSync(p)) return p;
+	}
+	return null;
+}
+/** The `plugins: [...]` array node inside a createApp call, if present. */
+function findPluginsArray(root) {
+	for (const pair of root.findAll({ rule: { kind: "pair" } })) {
+		if (pair.find({ rule: { kind: "property_identifier" } })?.text() !== "plugins") continue;
+		const arr = pair.find({ rule: { kind: "array" } });
+		if (arr) return arr;
+	}
+	return null;
+}
+function arrayElementNames(arr) {
+	const names = /* @__PURE__ */ new Set();
+	for (const child of arr.children()) if (child.kind() === "identifier") names.add(child.text());
+	else if (child.kind() === "call_expression") {
+		const callee = child.children()[0];
+		if (callee?.kind() === "identifier") names.add(callee.text());
+	}
+	return names;
+}
+/** Local binding names introduced by an import statement — default, namespace,
+* and named specifiers, with aliases resolved to the local name. */
+function importBindingNames(stmt) {
+	const names = /* @__PURE__ */ new Set();
+	const clause = stmt.find({ rule: { kind: "import_clause" } });
+	if (!clause) return names;
+	for (const child of clause.children()) {
+		const kind = child.kind();
+		if (kind === "identifier") names.add(child.text());
+		else if (kind === "namespace_import") {
+			const id = child.find({ rule: { kind: "identifier" } });
+			if (id) names.add(id.text());
+		} else if (kind === "named_imports") for (const spec of child.findAll({ rule: { kind: "import_specifier" } })) {
+			const local = spec.field("alias")?.text() ?? spec.field("name")?.text();
+			if (local) names.add(local);
+		}
+	}
+	return names;
+}
+/**
+* Best-effort: register a plugin in the server entry's `createApp({ plugins })`
+* call by inserting the import and adding it to the array. Only edits the
+* standard shape (a `plugins: [...]` array literal); returns `skipped` otherwise
+* so the caller can fall back to printing manual instructions. Idempotent.
+*/
+function registerPluginInServer(serverRoot, importPath, exportName) {
+	if (!JS_IDENTIFIER.test(exportName)) return {
+		status: "skipped",
+		reason: "invalid plugin export name"
+	};
+	if (!/^[.][./A-Za-z0-9_-]*$/.test(importPath)) return {
+		status: "skipped",
+		reason: "invalid plugin import path"
+	};
+	const serverFile = findServerFile(serverRoot);
+	if (!serverFile) return {
+		status: "skipped",
+		reason: "no server entry file found"
+	};
+	const content = fs.readFileSync(serverFile, "utf-8");
+	const root = parse(serverFile.endsWith(".tsx") ? Lang.Tsx : Lang.TypeScript, content).root();
+	const arr = findPluginsArray(root);
+	if (!arr) return {
+		status: "skipped",
+		reason: "no createApp({ plugins: [...] }) array found"
+	};
+	const file = path.relative(serverRoot, serverFile);
+	if (arrayElementNames(arr).has(exportName)) return {
+		status: "already",
+		file
+	};
+	const edits = [];
+	const newElem = `${exportName}()`;
+	const elementKinds = [
+		"identifier",
+		"call_expression",
+		"spread_element"
+	];
+	const firstEl = arr.children().find((c) => elementKinds.includes(c.kind()));
+	if (!firstEl) edits.push(arr.replace(`[${newElem}]`));
+	else {
+		const startIdx = firstEl.range().start.index;
+		const lineStart = content.lastIndexOf("\n", startIdx - 1);
+		const indent = content.slice(lineStart + 1, startIdx);
+		const sep = lineStart !== -1 && /^[ \t]*$/.test(indent) ? `,\n${indent}` : ", ";
+		edits.push(firstEl.replace(`${newElem}${sep}${firstEl.text()}`));
+	}
+	const importStmts = root.findAll({ rule: { kind: "import_statement" } });
+	const hasBinding = importStmts.some((s) => importBindingNames(s).has(exportName));
+	const importLine = `import { ${exportName} } from "${importPath}";`;
+	if (!hasBinding && importStmts.length > 0) {
+		const last = importStmts[importStmts.length - 1];
+		edits.push(last.replace(`${last.text()}\n${importLine}`));
+	}
+	let output = root.commitEdits(edits);
+	if (!hasBinding && importStmts.length === 0) output = `${importLine}\n${output}`;
+	fs.writeFileSync(serverFile, output);
+	return {
+		status: "wired",
+		file
+	};
+}
+
+//#endregion
+export { registerPluginInServer };
+//# sourceMappingURL=server-register.js.map

package/dist/cli/commands/registry/server-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-register.js","names":[],"sources":["../../../../src/cli/commands/registry/server-register.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { Lang, parse, type SgNode } from \"@ast-grep/napi\";\nimport { JS_IDENTIFIER } from \"./constants\";\n\n/** Server entry candidates within the server root, in priority order. */\nconst SERVER_FILE_CANDIDATES = [\n  \"server.ts\",\n  \"index.ts\",\n  \"src/server.ts\",\n  \"src/index.ts\",\n];\n\nexport interface RegisterResult {\n  /** wired = edited; already = plugin was present; skipped = couldn't safely edit. */\n  status: \"wired\" | \"already\" | \"skipped\";\n  file?: string;\n  reason?: string;\n}\n\nfunction findServerFile(serverRoot: string): string | null {\n  for (const candidate of SERVER_FILE_CANDIDATES) {\n    const p = path.join(serverRoot, candidate);\n    if (fs.existsSync(p)) return p;\n  }\n  return null;\n}\n\n/** The `plugins: [...]` array node inside a createApp call, if present. */\nfunction findPluginsArray(root: SgNode): SgNode | null {\n  for (const pair of root.findAll({ rule: { kind: \"pair\" } })) {\n    const key = pair.find({ rule: { kind: \"property_identifier\" } });\n    if (key?.text() !== \"plugins\") continue;\n    const arr = pair.find({ rule: { kind: \"array\" } });\n    if (arr) return arr;\n  }\n  return null;\n}\n\nfunction arrayElementNames(arr: SgNode): Set<string> {\n  const names = new Set<string>();\n  for (const child of arr.children()) {\n    if (child.kind() === \"identifier\") {\n      names.add(child.text());\n    } else if (child.kind() === \"call_expression\") {\n      const callee = child.children()[0];\n      if (callee?.kind() === \"identifier\") names.add(callee.text());\n    }\n  }\n  return names;\n}\n\n/** Local binding names introduced by an import statement — default, namespace,\n * and named specifiers, with aliases resolved to the local name. */\nfunction importBindingNames(stmt: SgNode): Set<string> {\n  const names = new Set<string>();\n  const clause = stmt.find({ rule: { kind: \"import_clause\" } });\n  if (!clause) return names;\n  for (const child of clause.children()) {\n    const kind = child.kind();\n    if (kind === \"identifier\") {\n      names.add(child.text());\n    } else if (kind === \"namespace_import\") {\n      const id = child.find({ rule: { kind: \"identifier\" } });\n      if (id) names.add(id.text());\n    } else if (kind === \"named_imports\") {\n      for (const spec of child.findAll({\n        rule: { kind: \"import_specifier\" },\n      })) {\n        const local = spec.field(\"alias\")?.text() ?? spec.field(\"name\")?.text();\n        if (local) names.add(local);\n      }\n    }\n  }\n  return names;\n}\n\n/**\n * Best-effort: register a plugin in the server entry's `createApp({ plugins })`\n * call by inserting the import and adding it to the array. Only edits the\n * standard shape (a `plugins: [...]` array literal); returns `skipped` otherwise\n * so the caller can fall back to printing manual instructions. Idempotent.\n */\nexport function registerPluginInServer(\n  serverRoot: string,\n  importPath: string,\n  exportName: string,\n): RegisterResult {\n  // exportName and importPath are interpolated into the user's server source.\n  // Registry items are untrusted, so refuse anything that isn't a plain JS\n  // identifier / clean relative module path — prevents code injection via a\n  // crafted export name or import path.\n  if (!JS_IDENTIFIER.test(exportName)) {\n    return { status: \"skipped\", reason: \"invalid plugin export name\" };\n  }\n  if (!/^[.][./A-Za-z0-9_-]*$/.test(importPath)) {\n    return { status: \"skipped\", reason: \"invalid plugin import path\" };\n  }\n\n  const serverFile = findServerFile(serverRoot);\n  if (!serverFile) {\n    return { status: \"skipped\", reason: \"no server entry file found\" };\n  }\n\n  const content = fs.readFileSync(serverFile, \"utf-8\");\n  const lang = serverFile.endsWith(\".tsx\") ? Lang.Tsx : Lang.TypeScript;\n  const root = parse(lang, content).root();\n\n  const arr = findPluginsArray(root);\n  if (!arr) {\n    return {\n      status: \"skipped\",\n      reason: \"no createApp({ plugins: [...] }) array found\",\n    };\n  }\n\n  const file = path.relative(serverRoot, serverFile);\n  if (arrayElementNames(arr).has(exportName)) {\n    return { status: \"already\", file };\n  }\n\n  const edits = [];\n\n  // toPlugin exports are factories, registered as a call: `hello()`.\n  const newElem = `${exportName}()`;\n\n  // Insert before the first element, matching its indentation so the array\n  // formatting is preserved (or inline for a single-line array).\n  const elementKinds = [\"identifier\", \"call_expression\", \"spread_element\"];\n  const firstEl = arr\n    .children()\n    .find((c) => elementKinds.includes(c.kind() as string));\n  if (!firstEl) {\n    edits.push(arr.replace(`[${newElem}]`));\n  } else {\n    const startIdx = firstEl.range().start.index;\n    const lineStart = content.lastIndexOf(\"\\n\", startIdx - 1);\n    const indent = content.slice(lineStart + 1, startIdx);\n    const multiline = lineStart !== -1 && /^[ \\t]*$/.test(indent);\n    const sep = multiline ? `,\\n${indent}` : \", \";\n    edits.push(firstEl.replace(`${newElem}${sep}${firstEl.text()}`));\n  }\n\n  // Add the import unless `exportName` is already bound by some import. De-dup\n  // on the binding, not the module path: an existing import from the same path\n  // under a different name (e.g. `import { HelloPlugin } from \"./plugins/hello\"`)\n  // must not suppress this one, or the `${exportName}()` element just added to\n  // the array would reference an unimported symbol and the server won't compile.\n  const importStmts = root.findAll({ rule: { kind: \"import_statement\" } });\n  const hasBinding = importStmts.some((s) =>\n    importBindingNames(s).has(exportName),\n  );\n  const importLine = `import { ${exportName} } from \"${importPath}\";`;\n  if (!hasBinding && importStmts.length > 0) {\n    const last = importStmts[importStmts.length - 1];\n    edits.push(last.replace(`${last.text()}\\n${importLine}`));\n  }\n\n  let output = root.commitEdits(edits);\n  if (!hasBinding && importStmts.length === 0) {\n    output = `${importLine}\\n${output}`;\n  }\n  fs.writeFileSync(serverFile, output);\n\n  return { status: \"wired\", file };\n}\n"],"mappings":"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"}

package/dist/cli/commands/registry/workspace-picker.js

@@ -0,0 +1,353 @@
+import { createWorkspaceClient } from "../../../workspace-client/factory.js";
+import { spawnSync } from "node:child_process";
+
+//#region src/cli/commands/registry/workspace-picker.ts
+/** Builds a `{value,label}` from an id field and optional label field. */
+function choiceFrom(item, idField, labelField) {
+	const id = item[idField];
+	if (id === void 0 || id === null) return null;
+	const value = String(id);
+	const rawLabel = labelField ? item[labelField] : void 0;
+	return {
+		value,
+		label: typeof rawLabel === "string" && rawLabel.length > 0 ? `${rawLabel} (${value})` : value
+	};
+}
+/**
+* Genie listSpaces returns a single page, not an auto-paginating iterable like
+* the other services. Adapt it to one that follows `next_page_token`; the
+* repeated-token guard avoids an infinite loop if the API echoes a token back.
+*/
+async function* iterateGenieSpaces(client) {
+	let pageToken;
+	do {
+		const res = await client.genie.listSpaces(pageToken ? { page_token: pageToken } : {});
+		for (const space of res.spaces ?? []) yield space;
+		const next = res.next_page_token;
+		if (next && next === pageToken) break;
+		pageToken = next;
+	} while (pageToken);
+}
+/** Flat, top-level listable resource types, backed by SDK services. */
+const SDK_LISTERS = {
+	sql_warehouse: {
+		list: (c) => c.warehouses.list({}),
+		toChoice: (i) => choiceFrom(i, "id", "name")
+	},
+	job: {
+		list: (c) => c.jobs.list({}),
+		toChoice: (i) => {
+			const settings = i.settings;
+			return choiceFrom({
+				...i,
+				name: settings?.name
+			}, "job_id", "name");
+		}
+	},
+	serving_endpoint: {
+		list: (c) => c.servingEndpoints.list(),
+		toChoice: (i) => choiceFrom(i, "name", "name")
+	},
+	uc_connection: {
+		list: (c) => c.connections.list({}),
+		toChoice: (i) => choiceFrom(i, "name", "full_name")
+	},
+	database: {
+		list: (c) => c.database.listDatabaseInstances({}),
+		toChoice: (i) => choiceFrom(i, "name", "name")
+	},
+	genie_space: {
+		list: iterateGenieSpaces,
+		toChoice: (i) => choiceFrom(i, "space_id", "title")
+	},
+	experiment: {
+		list: (c) => c.experiments.listExperiments({}),
+		toChoice: (i) => choiceFrom(i, "experiment_id", "name")
+	},
+	app: {
+		list: (c) => c.apps.list({}),
+		toChoice: (i) => choiceFrom(i, "name", "name")
+	}
+};
+/** True when a resource type can be listed flat (no parent context). */
+function isFlatListable(resourceType) {
+	return resourceType in SDK_LISTERS;
+}
+/**
+* Constructs a raw SDK workspace client for the given profile (or default
+* resolution), via the sanctioned `workspace-client` facade. Uses the legacy
+* escape hatch because the picker needs services (connections, database,
+* experiments, apps) the facade doesn't yet proxy directly.
+*/
+function makeWorkspaceClient(profile) {
+	return createWorkspaceClient(profile ? { profile } : {}).toLegacyWorkspaceClient();
+}
+/**
+* Max resources fetched for the picker. `list()` auto-paginates, so on a large
+* workspace (5000+ warehouses) breaking out at the cap stops pagination early;
+* the picker's "Enter manually" option covers anything beyond it.
+*/
+const MAX_PICKER_RESULTS = 200;
+/** First line of an error, capped, for a user-facing one-liner. */
+function shortErrorMessage(err) {
+	return (err instanceof Error ? err.message : String(err)).split("\n")[0].trim().slice(0, 200);
+}
+/**
+* Lists workspace resources of a flat-listable type via the SDK, stopping at
+* MAX_PICKER_RESULTS so pagination doesn't drain a huge workspace. Returns an
+* empty listing on any failure (unknown type, auth/config error, network) so
+* the caller can fall back to free-text entry. `clientFactory` is injectable
+* for tests.
+*/
+async function listWorkspaceResources(resourceType, profile, clientFactory = makeWorkspaceClient) {
+	const lister = SDK_LISTERS[resourceType];
+	if (!lister) return {
+		choices: [],
+		truncated: false
+	};
+	try {
+		const client = clientFactory(profile);
+		const choices = [];
+		let truncated = false;
+		for await (const item of lister.list(client)) {
+			if (typeof item !== "object" || item === null) continue;
+			const choice = lister.toChoice(item);
+			if (!choice) continue;
+			choices.push(choice);
+			if (choices.length >= MAX_PICKER_RESULTS) {
+				truncated = true;
+				break;
+			}
+		}
+		return {
+			choices,
+			truncated
+		};
+	} catch (err) {
+		return {
+			choices: [],
+			truncated: false,
+			error: shortErrorMessage(err)
+		};
+	}
+}
+const defaultRunner = (args) => {
+	const res = spawnSync("databricks", args, {
+		encoding: "utf-8",
+		maxBuffer: 64 * 1024 * 1024
+	});
+	return {
+		status: res.status,
+		stdout: res.stdout ?? ""
+	};
+};
+/**
+* Extracts `{value,label}` choices from a parsed CLI list response. The CLI
+* returns either a bare array or an object wrapping one; we scan for the first
+* array of objects. Items missing the id field are skipped.
+*/
+function toChoices(parsed, idField, labelField) {
+	const arr = firstArray(parsed);
+	const choices = [];
+	for (const item of arr) {
+		if (typeof item !== "object" || item === null) continue;
+		const choice = choiceFrom(item, idField, labelField);
+		if (choice) choices.push(choice);
+	}
+	return choices;
+}
+/** Finds the first array in a CLI response (bare array or single wrapper key). */
+function firstArray(parsed) {
+	if (Array.isArray(parsed)) return parsed;
+	if (parsed && typeof parsed === "object") {
+		for (const v of Object.values(parsed)) if (Array.isArray(v)) return v;
+	}
+	return [];
+}
+/**
+* Runs a `databricks … list -o json` command and returns parsed choices, or
+* [] on any failure (CLI missing/errored, empty, non-JSON). `command` is the
+* argv after `databricks`; `-o json` and `-p <profile>` are appended.
+* Used for the parent-context drill-down (catalogs/schemas/scopes/endpoints).
+*/
+function runList(command, idField, labelField, profile, runner = defaultRunner) {
+	const args = [
+		...command,
+		"-o",
+		"json"
+	];
+	if (profile) args.push("-p", profile);
+	let result;
+	try {
+		result = runner(args);
+	} catch {
+		return [];
+	}
+	if (result.status !== 0 || !result.stdout.trim()) return [];
+	let parsed;
+	try {
+		parsed = JSON.parse(result.stdout);
+	} catch {
+		return [];
+	}
+	return toChoices(parsed, idField, labelField);
+}
+/**
+* Drill-down chains for parent-context resource types. Each ends by listing
+* the resource itself; earlier steps list the parents to pick first.
+* Positional-arg CLI gotcha: `databricks schemas list <CATALOG>` etc. take the
+* parent as a positional, not a flag.
+*/
+const PARENT_CONTEXT_CHAINS = {
+	volume: [
+		{
+			key: "catalog",
+			list: () => ({
+				command: ["catalogs", "list"],
+				idField: "name",
+				labelField: "name"
+			})
+		},
+		{
+			key: "schema",
+			list: ([catalog]) => ({
+				command: [
+					"schemas",
+					"list",
+					catalog
+				],
+				idField: "name",
+				labelField: "name"
+			})
+		},
+		{
+			key: "volume",
+			list: ([catalog, schema]) => ({
+				command: [
+					"volumes",
+					"list",
+					catalog,
+					schema
+				],
+				idField: "full_name",
+				labelField: "name"
+			})
+		}
+	],
+	uc_function: [
+		{
+			key: "catalog",
+			list: () => ({
+				command: ["catalogs", "list"],
+				idField: "name",
+				labelField: "name"
+			})
+		},
+		{
+			key: "schema",
+			list: ([catalog]) => ({
+				command: [
+					"schemas",
+					"list",
+					catalog
+				],
+				idField: "name",
+				labelField: "name"
+			})
+		},
+		{
+			key: "function",
+			list: ([catalog, schema]) => ({
+				command: [
+					"functions",
+					"list",
+					catalog,
+					schema
+				],
+				idField: "full_name",
+				labelField: "name"
+			})
+		}
+	],
+	secret: [{
+		key: "scope",
+		list: () => ({
+			command: ["secrets", "list-scopes"],
+			idField: "name",
+			labelField: "name"
+		})
+	}, {
+		key: "key",
+		list: ([scope]) => ({
+			command: [
+				"secrets",
+				"list-secrets",
+				scope
+			],
+			idField: "key",
+			labelField: "key"
+		})
+	}],
+	vector_search_index: [{
+		key: "endpoint",
+		list: () => ({
+			command: ["vector-search-endpoints", "list-endpoints"],
+			idField: "name",
+			labelField: "name"
+		})
+	}, {
+		key: "index",
+		list: ([endpoint]) => ({
+			command: [
+				"vector-search-indexes",
+				"list-indexes",
+				endpoint
+			],
+			idField: "name",
+			labelField: "name"
+		})
+	}]
+};
+/** True when a resource type needs a parent-context drill-down to list. */
+function isParentContext(resourceType) {
+	return resourceType in PARENT_CONTEXT_CHAINS;
+}
+/**
+* Lists the choices for a single drill-down step given the values picked so
+* far. Returns [] on failure. The caller drives the interaction (present
+* `choices`, collect a pick, call again with it appended to `parents`).
+*/
+function listParentContextStep(resourceType, stepIndex, parents, profile, runner = defaultRunner) {
+	const chain = PARENT_CONTEXT_CHAINS[resourceType];
+	if (!chain || stepIndex >= chain.length) return null;
+	const step = chain[stepIndex];
+	if (parents.some((p) => p.startsWith("-"))) return {
+		key: step.key,
+		choices: []
+	};
+	const spec = step.list(parents);
+	return {
+		key: step.key,
+		choices: runList(spec.command, spec.idField, spec.labelField, profile, runner)
+	};
+}
+/** Number of drill-down steps for a parent-context type (0 if not one). */
+function parentContextDepth(resourceType) {
+	return PARENT_CONTEXT_CHAINS[resourceType]?.length ?? 0;
+}
+/**
+* Builds the final resource identifier from the values picked across a
+* drill-down. Most types end on a self-qualified id (volume/uc_function list
+* `full_name`; a vector-search index name is already catalog.schema-qualified),
+* so the last pick is the whole answer. A `secret` is addressed by both its
+* scope and key (`scope/key`) — returning only the key drops the scope and
+* yields a value that can't locate the secret — so its picks are joined.
+*/
+function composeResourceId(resourceType, picks) {
+	if (resourceType === "secret") return picks.join("/");
+	return picks[picks.length - 1];
+}
+
+//#endregion
+export { composeResourceId, isFlatListable, isParentContext, listParentContextStep, listWorkspaceResources, parentContextDepth };
+//# sourceMappingURL=workspace-picker.js.map

package/dist/cli/commands/registry/workspace-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-picker.js","names":[],"sources":["../../../../src/cli/commands/registry/workspace-picker.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport {\n  createWorkspaceClient,\n  type LegacyWorkspaceClient,\n} from \"../../../workspace-client\";\n\n/**\n * Lists a user's real Databricks workspace resources so `appkit add` can offer\n * a picker instead of blind free-text entry.\n *\n * Flat resource types are listed via the Databricks SDK client (typed,\n * auto-paginating) obtained through the sanctioned `workspace-client` facade.\n * Parent-context types (volume, uc_function, secret, vector_search_index) still\n * shell out to the `databricks` CLI for their drill-down. Every path fails\n * soft: any error returns an empty list and the caller drops to free-text entry.\n */\n\n/** A workspace resource choice surfaced in the picker. */\nexport interface WorkspaceChoice {\n  /** Value written to the env var (the resource id/name). */\n  value: string;\n  /** Human label shown in the picker (name, falling back to value). */\n  label: string;\n}\n\n/**\n * Per-type SDK lister: streams a resource type off the WorkspaceClient into\n * `{value,label}` choices. `list()` returns an async iterable of raw SDK\n * objects; `toChoice` maps each to a picker choice. The SDK auto-paginates, so\n * we simply iterate to completion.\n */\ninterface SdkLister {\n  list: (client: LegacyWorkspaceClient) => AsyncIterable<unknown>;\n  toChoice: (item: Record<string, unknown>) => WorkspaceChoice | null;\n}\n\n/** Builds a `{value,label}` from an id field and optional label field. */\nfunction choiceFrom(\n  item: Record<string, unknown>,\n  idField: string,\n  labelField?: string,\n): WorkspaceChoice | null {\n  const id = item[idField];\n  if (id === undefined || id === null) return null;\n  const value = String(id);\n  const rawLabel = labelField ? item[labelField] : undefined;\n  const label =\n    typeof rawLabel === \"string\" && rawLabel.length > 0\n      ? `${rawLabel} (${value})`\n      : value;\n  return { value, label };\n}\n\n/**\n * Genie listSpaces returns a single page, not an auto-paginating iterable like\n * the other services. Adapt it to one that follows `next_page_token`; the\n * repeated-token guard avoids an infinite loop if the API echoes a token back.\n */\nasync function* iterateGenieSpaces(\n  client: LegacyWorkspaceClient,\n): AsyncIterable<unknown> {\n  let pageToken: string | undefined;\n  do {\n    const res = await client.genie.listSpaces(\n      pageToken ? { page_token: pageToken } : {},\n    );\n    for (const space of res.spaces ?? []) yield space;\n    const next = res.next_page_token;\n    if (next && next === pageToken) break;\n    pageToken = next;\n  } while (pageToken);\n}\n\n/** Flat, top-level listable resource types, backed by SDK services. */\nexport const SDK_LISTERS: Record<string, SdkLister> = {\n  sql_warehouse: {\n    list: (c) => c.warehouses.list({}),\n    toChoice: (i) => choiceFrom(i, \"id\", \"name\"),\n  },\n  job: {\n    list: (c) => c.jobs.list({}),\n    // job name lives under settings.name; id is top-level job_id\n    toChoice: (i) => {\n      const settings = i.settings as { name?: string } | undefined;\n      return choiceFrom({ ...i, name: settings?.name }, \"job_id\", \"name\");\n    },\n  },\n  serving_endpoint: {\n    list: (c) => c.servingEndpoints.list(),\n    toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n  },\n  uc_connection: {\n    list: (c) => c.connections.list({}),\n    toChoice: (i) => choiceFrom(i, \"name\", \"full_name\"),\n  },\n  database: {\n    list: (c) => c.database.listDatabaseInstances({}),\n    toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n  },\n  genie_space: {\n    list: iterateGenieSpaces,\n    toChoice: (i) => choiceFrom(i, \"space_id\", \"title\"),\n  },\n  experiment: {\n    list: (c) => c.experiments.listExperiments({}),\n    toChoice: (i) => choiceFrom(i, \"experiment_id\", \"name\"),\n  },\n  app: {\n    list: (c) => c.apps.list({}),\n    toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n  },\n};\n\n/** True when a resource type can be listed flat (no parent context). */\nexport function isFlatListable(resourceType: string): boolean {\n  return resourceType in SDK_LISTERS;\n}\n\n/**\n * Constructs a raw SDK workspace client for the given profile (or default\n * resolution), via the sanctioned `workspace-client` facade. Uses the legacy\n * escape hatch because the picker needs services (connections, database,\n * experiments, apps) the facade doesn't yet proxy directly.\n */\nexport function makeWorkspaceClient(profile?: string): LegacyWorkspaceClient {\n  return createWorkspaceClient(\n    profile ? { profile } : {},\n  ).toLegacyWorkspaceClient();\n}\n\n/**\n * Max resources fetched for the picker. `list()` auto-paginates, so on a large\n * workspace (5000+ warehouses) breaking out at the cap stops pagination early;\n * the picker's \"Enter manually\" option covers anything beyond it.\n */\nexport const MAX_PICKER_RESULTS = 200;\n\n/** A listing result plus whether it was truncated at the fetch cap. */\nexport interface WorkspaceListing {\n  choices: WorkspaceChoice[];\n  truncated: boolean;\n  /** Short reason the listing failed (auth/config/network), if it did — lets\n   * the caller distinguish a real error from a genuinely empty workspace. */\n  error?: string;\n}\n\n/** First line of an error, capped, for a user-facing one-liner. */\nfunction shortErrorMessage(err: unknown): string {\n  const msg = err instanceof Error ? err.message : String(err);\n  return msg.split(\"\\n\")[0].trim().slice(0, 200);\n}\n\n/**\n * Lists workspace resources of a flat-listable type via the SDK, stopping at\n * MAX_PICKER_RESULTS so pagination doesn't drain a huge workspace. Returns an\n * empty listing on any failure (unknown type, auth/config error, network) so\n * the caller can fall back to free-text entry. `clientFactory` is injectable\n * for tests.\n */\nexport async function listWorkspaceResources(\n  resourceType: string,\n  profile?: string,\n  clientFactory: (\n    profile?: string,\n  ) => LegacyWorkspaceClient = makeWorkspaceClient,\n): Promise<WorkspaceListing> {\n  const lister = SDK_LISTERS[resourceType];\n  if (!lister) return { choices: [], truncated: false };\n  try {\n    const client = clientFactory(profile);\n    const choices: WorkspaceChoice[] = [];\n    let truncated = false;\n    for await (const item of lister.list(client)) {\n      if (typeof item !== \"object\" || item === null) continue;\n      const choice = lister.toChoice(item as Record<string, unknown>);\n      if (!choice) continue;\n      choices.push(choice);\n      if (choices.length >= MAX_PICKER_RESULTS) {\n        // Stop iterating — halts the async iterator, so no further pages fetch.\n        truncated = true;\n        break;\n      }\n    }\n    return { choices, truncated };\n  } catch (err) {\n    // Don't swallow silently: return the reason so the caller can tell the user\n    // the picker fell back because listing failed (typically auth/profile), not\n    // because the workspace has none of this resource.\n    return { choices: [], truncated: false, error: shortErrorMessage(err) };\n  }\n}\n\n/** Runs a databricks CLI subcommand returning JSON; injectable for tests. */\nexport type CliRunner = (args: string[]) => {\n  status: number | null;\n  stdout: string;\n};\n\nconst defaultRunner: CliRunner = (args) => {\n  // Parent-context lists can be large; raise maxBuffer well above the 1MB\n  // default so a big JSON response isn't truncated into \"no resources found\".\n  const res = spawnSync(\"databricks\", args, {\n    encoding: \"utf-8\",\n    maxBuffer: 64 * 1024 * 1024,\n  });\n  return { status: res.status, stdout: res.stdout ?? \"\" };\n};\n\n/**\n * Extracts `{value,label}` choices from a parsed CLI list response. The CLI\n * returns either a bare array or an object wrapping one; we scan for the first\n * array of objects. Items missing the id field are skipped.\n */\nexport function toChoices(\n  parsed: unknown,\n  idField: string,\n  labelField?: string,\n): WorkspaceChoice[] {\n  const arr = firstArray(parsed);\n  const choices: WorkspaceChoice[] = [];\n  for (const item of arr) {\n    if (typeof item !== \"object\" || item === null) continue;\n    const choice = choiceFrom(\n      item as Record<string, unknown>,\n      idField,\n      labelField,\n    );\n    if (choice) choices.push(choice);\n  }\n  return choices;\n}\n\n/** Finds the first array in a CLI response (bare array or single wrapper key). */\nfunction firstArray(parsed: unknown): unknown[] {\n  if (Array.isArray(parsed)) return parsed;\n  if (parsed && typeof parsed === \"object\") {\n    for (const v of Object.values(parsed)) {\n      if (Array.isArray(v)) return v;\n    }\n  }\n  return [];\n}\n\n/**\n * Runs a `databricks … list -o json` command and returns parsed choices, or\n * [] on any failure (CLI missing/errored, empty, non-JSON). `command` is the\n * argv after `databricks`; `-o json` and `-p <profile>` are appended.\n * Used for the parent-context drill-down (catalogs/schemas/scopes/endpoints).\n */\nexport function runList(\n  command: string[],\n  idField: string,\n  labelField: string | undefined,\n  profile: string | undefined,\n  runner: CliRunner = defaultRunner,\n): WorkspaceChoice[] {\n  const args = [...command, \"-o\", \"json\"];\n  if (profile) args.push(\"-p\", profile);\n\n  let result: { status: number | null; stdout: string };\n  try {\n    result = runner(args);\n  } catch {\n    return [];\n  }\n  if (result.status !== 0 || !result.stdout.trim()) return [];\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(result.stdout);\n  } catch {\n    return [];\n  }\n  return toChoices(parsed, idField, labelField);\n}\n\n/**\n * A drill-down step for a parent-context resource type. `list(parents)` builds\n * the CLI argv given the values picked in prior steps (e.g. [catalog] → schema\n * list command). `key` labels the step for prompts.\n */\nexport interface ParentContextStep {\n  key: string;\n  list: (parents: string[]) => {\n    command: string[];\n    idField: string;\n    labelField?: string;\n  };\n}\n\n/**\n * Drill-down chains for parent-context resource types. Each ends by listing\n * the resource itself; earlier steps list the parents to pick first.\n * Positional-arg CLI gotcha: `databricks schemas list <CATALOG>` etc. take the\n * parent as a positional, not a flag.\n */\nexport const PARENT_CONTEXT_CHAINS: Record<string, ParentContextStep[]> = {\n  volume: [\n    {\n      key: \"catalog\",\n      list: () => ({\n        command: [\"catalogs\", \"list\"],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n    {\n      key: \"schema\",\n      list: ([catalog]) => ({\n        command: [\"schemas\", \"list\", catalog],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n    {\n      key: \"volume\",\n      list: ([catalog, schema]) => ({\n        command: [\"volumes\", \"list\", catalog, schema],\n        idField: \"full_name\",\n        labelField: \"name\",\n      }),\n    },\n  ],\n  uc_function: [\n    {\n      key: \"catalog\",\n      list: () => ({\n        command: [\"catalogs\", \"list\"],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n    {\n      key: \"schema\",\n      list: ([catalog]) => ({\n        command: [\"schemas\", \"list\", catalog],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n    {\n      key: \"function\",\n      list: ([catalog, schema]) => ({\n        command: [\"functions\", \"list\", catalog, schema],\n        idField: \"full_name\",\n        labelField: \"name\",\n      }),\n    },\n  ],\n  secret: [\n    {\n      key: \"scope\",\n      list: () => ({\n        command: [\"secrets\", \"list-scopes\"],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n    {\n      key: \"key\",\n      list: ([scope]) => ({\n        command: [\"secrets\", \"list-secrets\", scope],\n        idField: \"key\",\n        labelField: \"key\",\n      }),\n    },\n  ],\n  vector_search_index: [\n    {\n      key: \"endpoint\",\n      list: () => ({\n        command: [\"vector-search-endpoints\", \"list-endpoints\"],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n    {\n      key: \"index\",\n      list: ([endpoint]) => ({\n        command: [\"vector-search-indexes\", \"list-indexes\", endpoint],\n        idField: \"name\",\n        labelField: \"name\",\n      }),\n    },\n  ],\n};\n\n/** True when a resource type needs a parent-context drill-down to list. */\nexport function isParentContext(resourceType: string): boolean {\n  return resourceType in PARENT_CONTEXT_CHAINS;\n}\n\n/** One resolved step of a drill-down: the choices to present at this level. */\nexport interface DrillStep {\n  key: string;\n  choices: WorkspaceChoice[];\n}\n\n/**\n * Lists the choices for a single drill-down step given the values picked so\n * far. Returns [] on failure. The caller drives the interaction (present\n * `choices`, collect a pick, call again with it appended to `parents`).\n */\nexport function listParentContextStep(\n  resourceType: string,\n  stepIndex: number,\n  parents: string[],\n  profile?: string,\n  runner: CliRunner = defaultRunner,\n): DrillStep | null {\n  const chain = PARENT_CONTEXT_CHAINS[resourceType];\n  if (!chain || stepIndex >= chain.length) return null;\n  const step = chain[stepIndex];\n  // Prior picks become positional CLI args; a value starting with `-` would be\n  // parsed as a flag, so refuse it (empty step → free-text fallback). Real\n  // catalog/schema/scope/endpoint names never start with `-`.\n  if (parents.some((p) => p.startsWith(\"-\"))) {\n    return { key: step.key, choices: [] };\n  }\n  const spec = step.list(parents);\n  return {\n    key: step.key,\n    choices: runList(\n      spec.command,\n      spec.idField,\n      spec.labelField,\n      profile,\n      runner,\n    ),\n  };\n}\n\n/** Number of drill-down steps for a parent-context type (0 if not one). */\nexport function parentContextDepth(resourceType: string): number {\n  return PARENT_CONTEXT_CHAINS[resourceType]?.length ?? 0;\n}\n\n/**\n * Builds the final resource identifier from the values picked across a\n * drill-down. Most types end on a self-qualified id (volume/uc_function list\n * `full_name`; a vector-search index name is already catalog.schema-qualified),\n * so the last pick is the whole answer. A `secret` is addressed by both its\n * scope and key (`scope/key`) — returning only the key drops the scope and\n * yields a value that can't locate the secret — so its picks are joined.\n */\nexport function composeResourceId(\n  resourceType: string,\n  picks: string[],\n): string {\n  if (resourceType === \"secret\") return picks.join(\"/\");\n  return picks[picks.length - 1];\n}\n"],"mappings":"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"}

package/dist/cli/deploy-config.js

@@ -0,0 +1,36 @@
+//#region src/cli/deploy-config.ts
+/**
+* Single source for the `app.yaml` + `databricks.yml` app-resource binding
+* contract, so the registry writer (`config-writer.ts`) and the doctor reader
+* (`bundle.ts`/`checks-wiring.ts`) on opposite ends of it can't drift apart.
+*/
+/** Canonical Databricks bundle config file name. */
+const DATABRICKS_YML_FILE = "databricks.yml";
+/** Canonical Databricks Apps runtime config file name. */
+const APP_YAML_FILE = "app.yaml";
+/**
+* Encodes a binding into its `databricks.yml` node: the type is the single
+* non-`name` object key. Inverse of {@link bindingTypeOf}.
+*/
+function bindingToNode(binding) {
+	const inner = { ...binding.fields };
+	if (binding.permission) inner.permission = binding.permission;
+	return {
+		name: binding.name,
+		[binding.type]: inner
+	};
+}
+/**
+* Reads the type back out of a `databricks.yml` binding node — the single
+* non-`name` object-valued property; undefined if absent. See {@link bindingToNode}.
+*/
+function bindingTypeOf(block) {
+	for (const [k, v] of Object.entries(block)) {
+		if (k === "name") continue;
+		if (v && typeof v === "object") return k;
+	}
+}
+
+//#endregion
+export { APP_YAML_FILE, DATABRICKS_YML_FILE, bindingToNode, bindingTypeOf };
+//# sourceMappingURL=deploy-config.js.map

package/dist/cli/deploy-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-config.js","names":[],"sources":["../../src/cli/deploy-config.ts"],"sourcesContent":["/**\n * Single source for the `app.yaml` + `databricks.yml` app-resource binding\n * contract, so the registry writer (`config-writer.ts`) and the doctor reader\n * (`bundle.ts`/`checks-wiring.ts`) on opposite ends of it can't drift apart.\n */\n\n/** Canonical Databricks bundle config file name. */\nexport const DATABRICKS_YML_FILE = \"databricks.yml\";\n\n/** Canonical Databricks Apps runtime config file name. */\nexport const APP_YAML_FILE = \"app.yaml\";\n\n/** An `app.yaml` env entry: `- name: <env>`, `valueFrom: <binding name>`. */\nexport interface AppYamlEnvEntry {\n  name: string;\n  valueFrom: string;\n}\n\n/**\n * A `databricks.yml` app-resource binding under `resources.apps.<app>.resources[]`,\n * serialized as `{ name, <type>: { ...fields, permission? } }` (see {@link bindingToNode}).\n */\nexport interface ResourceBinding {\n  /** Binding name — the `valueFrom` join key (equals the resourceKey). */\n  name: string;\n  /** Resource type key, e.g. `sql_warehouse` / `postgres`. */\n  type: string;\n  permission?: string;\n  /** Binding fields, typically `${var.<variable>}` references. */\n  fields: Record<string, string>;\n}\n\n/**\n * Encodes a binding into its `databricks.yml` node: the type is the single\n * non-`name` object key. Inverse of {@link bindingTypeOf}.\n */\nexport function bindingToNode(\n  binding: ResourceBinding,\n): Record<string, unknown> {\n  const inner: Record<string, unknown> = { ...binding.fields };\n  if (binding.permission) inner.permission = binding.permission;\n  return { name: binding.name, [binding.type]: inner };\n}\n\n/**\n * Reads the type back out of a `databricks.yml` binding node — the single\n * non-`name` object-valued property; undefined if absent. See {@link bindingToNode}.\n */\nexport function bindingTypeOf(\n  block: Record<string, unknown>,\n): string | undefined {\n  for (const [k, v] of Object.entries(block)) {\n    if (k === \"name\") continue;\n    if (v && typeof v === \"object\") return k;\n  }\n  return undefined;\n}\n"],"mappings":";;;;;;;AAOA,MAAa,sBAAsB;;AAGnC,MAAa,gBAAgB;;;;;AA0B7B,SAAgB,cACd,SACyB;CACzB,MAAM,QAAiC,EAAE,GAAG,QAAQ,QAAQ;AAC5D,KAAI,QAAQ,WAAY,OAAM,aAAa,QAAQ;AACnD,QAAO;EAAE,MAAM,QAAQ;GAAO,QAAQ,OAAO;EAAO;;;;;;AAOtD,SAAgB,cACd,OACoB;AACpB,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,MAAM,EAAE;AAC1C,MAAI,MAAM,OAAQ;AAClB,MAAI,KAAK,OAAO,MAAM,SAAU,QAAO"}

package/dist/cli/index.js

@@ -5,6 +5,8 @@ import { doctorCommand } from "./commands/doctor/index.js";
 import { generateTypesCommand } from "./commands/generate-types.js";
 import { lintCommand } from "./commands/lint.js";
 import { pluginCommand } from "./commands/plugin/index.js";
+import { addCommand } from "./commands/registry/add.js";
+import { registryCommand } from "./commands/registry/index.js";
 import { setupCommand } from "./commands/setup.js";
 import "dotenv/config";
 import { readFileSync } from "node:fs";
@@ -24,6 +26,8 @@ cmd.addCommand(docsCommand);
 cmd.addCommand(pluginCommand);
 cmd.addCommand(codemodCommand);
 cmd.addCommand(doctorCommand);
+cmd.addCommand(registryCommand, { hidden: true });
+cmd.addCommand(addCommand, { hidden: true });
 await cmd.parseAsync();
 
 //#endregion

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport \"dotenv/config\";\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Command } from \"commander\";\nimport { codemodCommand } from \"./commands/codemod/index.js\";\nimport { docsCommand } from \"./commands/docs.js\";\nimport { doctorCommand } from \"./commands/doctor/index.js\";\nimport { generateTypesCommand } from \"./commands/generate-types.js\";\nimport { lintCommand } from \"./commands/lint.js\";\nimport { pluginCommand } from \"./commands/plugin/index.js\";\nimport { setupCommand } from \"./commands/setup.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgPath = join(__dirname, \"../../package.json\");\nconst pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n\nconst cmd = new Command();\n\ncmd\n  .name(\"appkit\")\n  .description(\"CLI tools for Databricks AppKit\")\n  .version(pkg.version);\n\ncmd.addCommand(setupCommand);\ncmd.addCommand(generateTypesCommand);\ncmd.addCommand(lintCommand);\ncmd.addCommand(docsCommand);\ncmd.addCommand(pluginCommand);\ncmd.addCommand(codemodCommand);\ncmd.addCommand(doctorCommand);\n\nawait cmd.parseAsync();\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,UAAU,KADE,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EACzB,qBAAqB;AACrD,MAAM,MAAM,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC;AAEtD,MAAM,MAAM,IAAI,SAAS;AAEzB,IACG,KAAK,SAAS,CACd,YAAY,kCAAkC,CAC9C,QAAQ,IAAI,QAAQ;AAEvB,IAAI,WAAW,aAAa;AAC5B,IAAI,WAAW,qBAAqB;AACpC,IAAI,WAAW,YAAY;AAC3B,IAAI,WAAW,YAAY;AAC3B,IAAI,WAAW,cAAc;AAC7B,IAAI,WAAW,eAAe;AAC9B,IAAI,WAAW,cAAc;AAE7B,MAAM,IAAI,YAAY"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport \"dotenv/config\";\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Command } from \"commander\";\nimport { codemodCommand } from \"./commands/codemod/index.js\";\nimport { docsCommand } from \"./commands/docs.js\";\nimport { doctorCommand } from \"./commands/doctor/index.js\";\nimport { generateTypesCommand } from \"./commands/generate-types.js\";\nimport { lintCommand } from \"./commands/lint.js\";\nimport { pluginCommand } from \"./commands/plugin/index.js\";\nimport { addCommand } from \"./commands/registry/add.js\";\nimport { registryCommand } from \"./commands/registry/index.js\";\nimport { setupCommand } from \"./commands/setup.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgPath = join(__dirname, \"../../package.json\");\nconst pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n\nconst cmd = new Command();\n\ncmd\n  .name(\"appkit\")\n  .description(\"CLI tools for Databricks AppKit\")\n  .version(pkg.version);\n\ncmd.addCommand(setupCommand);\ncmd.addCommand(generateTypesCommand);\ncmd.addCommand(lintCommand);\ncmd.addCommand(docsCommand);\ncmd.addCommand(pluginCommand);\ncmd.addCommand(codemodCommand);\ncmd.addCommand(doctorCommand);\n// Registry commands are executable but hidden from --help while the feature\n// is still in development (registry + add work end-to-end but aren't announced).\ncmd.addCommand(registryCommand, { hidden: true });\ncmd.addCommand(addCommand, { hidden: true });\n\nawait cmd.parseAsync();\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAM,UAAU,KADE,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EACzB,qBAAqB;AACrD,MAAM,MAAM,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC;AAEtD,MAAM,MAAM,IAAI,SAAS;AAEzB,IACG,KAAK,SAAS,CACd,YAAY,kCAAkC,CAC9C,QAAQ,IAAI,QAAQ;AAEvB,IAAI,WAAW,aAAa;AAC5B,IAAI,WAAW,qBAAqB;AACpC,IAAI,WAAW,YAAY;AAC3B,IAAI,WAAW,YAAY;AAC3B,IAAI,WAAW,cAAc;AAC7B,IAAI,WAAW,eAAe;AAC9B,IAAI,WAAW,cAAc;AAG7B,IAAI,WAAW,iBAAiB,EAAE,QAAQ,MAAM,CAAC;AACjD,IAAI,WAAW,YAAY,EAAE,QAAQ,MAAM,CAAC;AAE5C,MAAM,IAAI,YAAY"}

package/dist/connectors/context.js

@@ -1,5 +1,4 @@
-import { Context } from "../workspace-client/legacy.js";
-import "../workspace-client/index.js";
+import { Context } from "../shared/src/workspace-client/legacy.js";
 
 //#region src/connectors/context.ts
 /**

package/dist/connectors/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/connectors/context.ts"],"sourcesContent":["import { type CancellationToken, Context } from \"../workspace-client\";\n\n/**\n * Bridges {@link AbortSignal} to the SDK's {@link CancellationToken} so\n * `apiClient.request` can abort the outbound HTTP request (and stop pulling a\n * response body) when the caller aborts.\n */\nfunction cancellationTokenFromAbortSignal(\n  signal: AbortSignal,\n): CancellationToken {\n  const listeners = new Set<() => void>();\n  signal.addEventListener(\n    \"abort\",\n    () => {\n      for (const cb of listeners) {\n        try {\n          cb();\n        } catch {\n          // ignore listener failures — abort must stay best-effort\n        }\n      }\n    },\n    { passive: true },\n  );\n\n  return {\n    get isCancellationRequested() {\n      return signal.aborted;\n    },\n    onCancellationRequested(callback: (e?: unknown) => unknown) {\n      listeners.add(callback as () => void);\n      if (signal.aborted) {\n        void callback();\n      }\n    },\n  };\n}\n\n/**\n * Wraps an optional {@link AbortSignal} in an SDK {@link Context} for the\n * second argument of `apiClient.request`. Returns `undefined` when no signal\n * is given, so callers can pass the result straight through.\n */\nexport function contextFromAbortSignal(\n  signal?: AbortSignal,\n): InstanceType<typeof Context> | undefined {\n  return signal\n    ? new Context({\n        cancellationToken: cancellationTokenFromAbortSignal(signal),\n      })\n    : undefined;\n}\n"],"mappings":";;;;;;;;;AAOA,SAAS,iCACP,QACmB;CACnB,MAAM,4BAAY,IAAI,KAAiB;AACvC,QAAO,iBACL,eACM;AACJ,OAAK,MAAM,MAAM,UACf,KAAI;AACF,OAAI;UACE;IAKZ,EAAE,SAAS,MAAM,CAClB;AAED,QAAO;EACL,IAAI,0BAA0B;AAC5B,UAAO,OAAO;;EAEhB,wBAAwB,UAAoC;AAC1D,aAAU,IAAI,SAAuB;AACrC,OAAI,OAAO,QACT,CAAK,UAAU;;EAGpB;;;;;;;AAQH,SAAgB,uBACd,QAC0C;AAC1C,QAAO,SACH,IAAI,QAAQ,EACV,mBAAmB,iCAAiC,OAAO,EAC5D,CAAC,GACF"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/connectors/context.ts"],"sourcesContent":["import { type CancellationToken, Context } from \"../workspace-client\";\n\n/**\n * Bridges {@link AbortSignal} to the SDK's {@link CancellationToken} so\n * `apiClient.request` can abort the outbound HTTP request (and stop pulling a\n * response body) when the caller aborts.\n */\nfunction cancellationTokenFromAbortSignal(\n  signal: AbortSignal,\n): CancellationToken {\n  const listeners = new Set<() => void>();\n  signal.addEventListener(\n    \"abort\",\n    () => {\n      for (const cb of listeners) {\n        try {\n          cb();\n        } catch {\n          // ignore listener failures — abort must stay best-effort\n        }\n      }\n    },\n    { passive: true },\n  );\n\n  return {\n    get isCancellationRequested() {\n      return signal.aborted;\n    },\n    onCancellationRequested(callback: (e?: unknown) => unknown) {\n      listeners.add(callback as () => void);\n      if (signal.aborted) {\n        void callback();\n      }\n    },\n  };\n}\n\n/**\n * Wraps an optional {@link AbortSignal} in an SDK {@link Context} for the\n * second argument of `apiClient.request`. Returns `undefined` when no signal\n * is given, so callers can pass the result straight through.\n */\nexport function contextFromAbortSignal(\n  signal?: AbortSignal,\n): InstanceType<typeof Context> | undefined {\n  return signal\n    ? new Context({\n        cancellationToken: cancellationTokenFromAbortSignal(signal),\n      })\n    : undefined;\n}\n"],"mappings":";;;;;;;;AAOA,SAAS,iCACP,QACmB;CACnB,MAAM,4BAAY,IAAI,KAAiB;AACvC,QAAO,iBACL,eACM;AACJ,OAAK,MAAM,MAAM,UACf,KAAI;AACF,OAAI;UACE;IAKZ,EAAE,SAAS,MAAM,CAClB;AAED,QAAO;EACL,IAAI,0BAA0B;AAC5B,UAAO,OAAO;;EAEhB,wBAAwB,UAAoC;AAC1D,aAAU,IAAI,SAAuB;AACrC,OAAI,OAAO,QACT,CAAK,UAAU;;EAGpB;;;;;;;AAQH,SAAgB,uBACd,QAC0C;AAC1C,QAAO,SACH,IAAI,QAAQ,EACV,mBAAmB,iCAAiC,OAAO,EAC5D,CAAC,GACF"}

package/dist/connectors/files/client.js

@@ -1,6 +1,5 @@
+import { ApiError } from "../../shared/src/workspace-client/errors.js";
 import { createLogger } from "../../logging/logger.js";
-import { ApiError } from "../../workspace-client/errors.js";
-import "../../workspace-client/index.js";
 import { TelemetryManager } from "../../telemetry/telemetry-manager.js";
 import { SpanKind, SpanStatusCode } from "../../telemetry/index.js";
 import { FILES_MAX_READ_SIZE, contentTypeFromPath, isTextContentType } from "./defaults.js";