@yugoo-design/dsh-design-studio-dsh 0.1.2 → 0.2.0

package/lib/authoring-session.types-MHEaEFkO.d.ts

@@ -0,0 +1,58 @@
+import { r as StudioAuthoringReference, t as StudioAuthoringObservation } from "./authoring-agent.types-QLa61eE6.js";
+import { Context } from "@deepseek-ai/cordis";
+import { DesignBundleVersionPin, StudioInstanceCandidate, StudioInstanceChangeRequest } from "@yugoo-design/dsh-design-studio";
+import { Agent } from "@deepseek-ai/dsh-agent";
+import { StudioAuthoringComponentCatalog, StudioAwaitable, StudioInstances } from "@yugoo-design/dsh-design-studio/node";
+//#region src/authoring-session.types.d.ts
+/** A projection of the existing S2/S1 receipt, not another candidate authority. */
+interface StudioSessionPrepared {
+  readonly request: StudioInstanceChangeRequest;
+  readonly candidate: StudioInstanceCandidate;
+}
+interface StudioAuthoringSessionOptions {
+  readonly ctx: Context;
+  readonly parent: Agent;
+  readonly instances: Pick<StudioInstances, 'read' | 'readFile' | 'prepareChanges'>;
+  readonly readComponents: () => StudioAwaitable<StudioAuthoringComponentCatalog>;
+  /** Host-selected isolated workspace, never a browser-supplied path. */
+  readonly workspaceRoot: string;
+  /** Caller persists the native address before H2 attempts dispatch. */
+  readonly retainReference: (reference: StudioAuthoringReference) => void | Promise<void>;
+}
+interface StudioSessionStart {
+  readonly invocationId: string;
+  readonly id: string;
+  readonly expectedRevision: number;
+  readonly paths: readonly string[];
+  readonly bundle?: DesignBundleVersionPin;
+  readonly prompt: string;
+  readonly signal?: AbortSignal;
+  readonly onPrepared?: (prepared: StudioSessionPrepared) => void | Promise<void>;
+}
+interface StudioSessionResume extends StudioSessionStart {
+  readonly previous: StudioAuthoringReference;
+  readonly explicit: true;
+}
+interface StudioSessionRun {
+  readonly reference: StudioAuthoringReference;
+  /** Native turn outcome, independently of candidate validity or user save. */
+  readonly result: Promise<StudioAuthoringObservation>;
+  observe(): Promise<StudioAuthoringObservation>;
+  cancel(options: {
+    readonly expectedTurn: number | null;
+  }): Promise<StudioAuthoringObservation>;
+  readPrepared(): StudioSessionPrepared | undefined;
+}
+interface StudioAuthoringSession {
+  start(request: StudioSessionStart): Promise<StudioSessionRun>;
+  resume(request: StudioSessionResume): Promise<StudioSessionRun>;
+  observe(reference: StudioAuthoringReference): Promise<StudioAuthoringObservation>;
+  /** Only this session object's exact retained run handle can be cancelled. */
+  cancel(reference: StudioAuthoringReference, options: {
+    readonly expectedTurn: number | null;
+  }): Promise<StudioAuthoringObservation>;
+  readPrepared(reference: StudioAuthoringReference): StudioSessionPrepared | undefined;
+  dispose(): Promise<void>;
+}
+//#endregion
+export { StudioSessionRun as a, StudioSessionResume as i, StudioAuthoringSessionOptions as n, StudioSessionStart as o, StudioSessionPrepared as r, StudioAuthoringSession as t };

package/lib/authoring-sources-BzRuEuub.d.ts

@@ -0,0 +1,17 @@
+import DesignService from "@yugoo-design/dsh-design-core";
+import { StudioInstanceAdapters, StudioInstances } from "@yugoo-design/dsh-design-studio/node";
+import { FileSystem } from "@deepseek-ai/dsh-fs";
+//#region src/authoring-sources.d.ts
+interface DshStudioInstanceSources {
+  readonly design: Pick<DesignService, 'listBundles' | 'resolveBundle' | 'resolveKit'>;
+  readonly fs: FileSystem;
+}
+/** A trusted library source for initial project copies, never a project registry. */
+declare function registerDshStudioCurrentKitSource(design: Pick<DesignService, 'registerCurrentKitSource' | 'listKits'>, instances: Pick<StudioInstances, 'list' | 'editCurrent' | 'loadKit'>): () => void;
+/**
+ * No source discovery, Node source I/O, stateRoot or native session. S2 remains
+ * the compiler, snapshot, composition and save owner, including its list policy.
+ */
+declare function createDshStudioInstanceAdapters({ design, fs }: DshStudioInstanceSources): StudioInstanceAdapters;
+//#endregion
+export { createDshStudioInstanceAdapters as n, registerDshStudioCurrentKitSource as r, DshStudioInstanceSources as t };

package/lib/authoring-sources.d.ts

@@ -0,0 +1,2 @@
+import { n as createDshStudioInstanceAdapters, r as registerDshStudioCurrentKitSource, t as DshStudioInstanceSources } from "./authoring-sources-BzRuEuub.js";
+export { DshStudioInstanceSources, createDshStudioInstanceAdapters, registerDshStudioCurrentKitSource };

package/lib/authoring-sources.js

@@ -0,0 +1,85 @@
+import { n as openInstalledSourceFiles, t as kitFileError } from "./kit-files-DKBlBOG8.js";
+import { DesignKitVersion } from "@yugoo-design/dsh-design-core";
+import { createStudioInstanceAdapters } from "@yugoo-design/dsh-design-studio/node";
+//#region src/authoring-sources.ts
+/** A trusted library source for initial project copies, never a project registry. */
+function registerDshStudioCurrentKitSource(design, instances) {
+	const records = async () => (await instances.list({ kind: "kit" })).filter((record) => record.kit);
+	return design.registerCurrentKitSource({
+		async load(name) {
+			const matches = (await records()).filter((record) => record.kit.name === name);
+			const selected = matches.find((record) => record.current) ?? matches[0];
+			if (selected) return instances.loadKit({
+				id: selected.id,
+				expectedRevision: selected.revision
+			});
+			const installed = design.listKits().find((kit) => kit.name === name);
+			if (!installed) return void 0;
+			const current = await instances.editCurrent({
+				kind: "kit",
+				kit: {
+					name: installed.name,
+					version: String(installed.version)
+				}
+			});
+			return instances.loadKit({
+				id: current.id,
+				expectedRevision: current.revision
+			});
+		},
+		async list() {
+			return (await records()).map((record) => ({
+				name: record.kit.name,
+				version: record.kit.version,
+				...record.description ? { description: record.description } : {}
+			}));
+		}
+	});
+}
+/**
+* No source discovery, Node source I/O, stateRoot or native session. S2 remains
+* the compiler, snapshot, composition and save owner, including its list policy.
+*/
+function createDshStudioInstanceAdapters({ design, fs }) {
+	const unavailable = (message) => kitFileError("studio.source_unavailable", message);
+	const bundle = (pin) => {
+		const content = design.resolveBundle(pin);
+		if (!content) throw unavailable(`Independent Bundle ${pin.name}@${pin.version} is not registered.`);
+		if ((content.skill.catalogName ?? content.skill.name) !== pin.name || String(content.skill.version) !== pin.version) throw kitFileError("studio.source_pin_mismatch", "Resolved Bundle differs from the exact requested pin.");
+		if (typeof content.sourceId !== "string" || !content.sourceId || content.sourceId.length > 4096 || /[\u0000-\u001f\u007f]/u.test(content.sourceId)) throw unavailable("Registered Bundle has no valid trusted sourceId.");
+		if (typeof content.resourceRoot !== "string" || !content.resourceRoot) throw unavailable("Registered Bundle has no resourceRoot.");
+		return {
+			sourceId: content.sourceId,
+			root: content.resourceRoot
+		};
+	};
+	return createStudioInstanceAdapters({
+		async listBundles() {
+			const skills = design.listBundles();
+			if (skills.length > 1024) throw kitFileError("studio.source_limit", "Bundle catalog exceeds 1024 entries.");
+			return skills.map((skill) => ({
+				name: skill.catalogName ?? skill.name,
+				version: String(skill.version)
+			})).filter((pin) => design.resolveBundle(pin) !== void 0).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : a.version < b.version ? -1 : a.version > b.version ? 1 : 0);
+		},
+		async captureBundle(pin) {
+			const { root, sourceId } = bundle(pin);
+			return {
+				sourceId,
+				files: await (await openInstalledSourceFiles(fs, root)).captureTree()
+			};
+		},
+		async captureKit(pin) {
+			const kit = design.resolveKit({
+				kit: pin.name,
+				version: DesignKitVersion(pin.version)
+			});
+			if (!kit) throw unavailable(`Kit ${pin.name}@${pin.version} is not registered.`);
+			if (kit.name !== pin.name || String(kit.version) !== pin.version) throw kitFileError("studio.source_pin_mismatch", "Resolved Kit differs from the exact requested pin.");
+			if (typeof kit.sourceRoot !== "string" || !kit.sourceRoot) throw unavailable("Registered Kit has no sourceRoot.");
+			return { files: await (await openInstalledSourceFiles(fs, kit.sourceRoot, "Kit")).captureTree() };
+		}
+	});
+}
+//#endregion
+export { createDshStudioInstanceAdapters, registerDshStudioCurrentKitSource };

package/lib/authoring-workbench.d.ts

@@ -0,0 +1,15 @@
+import { a as StudioPreparedLocator } from "./authoring-host.types-d5UT0WEk.js";
+import { n as StudioPageAuthoringClient } from "./authoring.page-rpc-Bg6VAT0Z.js";
+import { InstanceWorkbenchProps } from "@yugoo-design/dsh-design-studio-ui";
+//#region src/authoring-workbench.d.ts
+interface StudioAuthoringWorkbenchProps extends Omit<InstanceWorkbenchProps, 'client' | 'renderSupplement' | 'embedded' | 'initialView' | 'sourceChanges'> {
+  /** Already scoped to the native parent by the page. Identity changes invalidate this open editor. */
+  client: StudioPageAuthoringClient;
+  presentation?: 'content-only' | 'full';
+  preparedLocator?: StudioPreparedLocator;
+  initialPrompt?: string;
+}
+declare const StudioAuthoringPromptContext: import("react").Context<string | undefined>;
+declare function StudioAuthoringWorkbench(props: StudioAuthoringWorkbenchProps): import("react").JSX.Element;
+//#endregion
+export { StudioAuthoringPromptContext, StudioAuthoringWorkbench, StudioAuthoringWorkbenchProps };