@intent-framework/core 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/graph.d.ts

@@ -7,11 +7,14 @@ export type GraphDiagnostic = {
     code: string;
     message: string;
     nodeId?: string;
+    semanticNodeId?: string;
 };
 export type InspectedScreen = {
     name: string;
+    semanticId: string;
     asks: Array<{
         id: string;
+        semanticId: string;
         label: string;
         kind: string;
         required: boolean;
@@ -21,6 +24,7 @@ export type InspectedScreen = {
     }>;
     acts: Array<{
         id: string;
+        semanticId: string;
         label: string;
         primary: boolean;
         enabled: boolean;
@@ -31,16 +35,19 @@ export type InspectedScreen = {
     }>;
     flows: Array<{
         id: string;
+        semanticId: string;
         name: string;
         stepCount: number;
     }>;
     surfaces: Array<{
         id: string;
+        semanticId: string;
         name: string;
         itemCount: number;
     }>;
     resources: Array<{
         id: string;
+        semanticId: string;
         name: string;
         status: string;
         hasValue: boolean;

package/dist/index.js

@@ -351,6 +351,11 @@ function getSurfaces() {
 function getResources() {
 	return resourceMap;
 }
+function nextSuffix(baseId, exists) {
+	let counter = 2;
+	while (exists(`${baseId}-${counter}`)) counter++;
+	return `${baseId}-${counter}`;
+}
 
 //#endregion
 //#region src/ask.ts
@@ -408,7 +413,9 @@ function computeAskError(node) {
 var AskBuilder = class {
 	node;
 	constructor(label, stateRef) {
-		const id = `ask_${label.toLowerCase().replace(/\s+/g, "_")}`;
+		const baseId = `ask_${label.toLowerCase().replace(/\s+/g, "_")}`;
+		const existing = getAsks();
+		const id = existing.has(baseId) ? nextSuffix(baseId, (id$1) => existing.has(id$1)) : baseId;
 		const onChange = stateRef.onChange;
 		const subscribeToState = onChange ? (fn) => onChange((_v) => fn()) : void 0;
 		this.node = createAskNode(id, label, stateRef, subscribeToState);
@@ -520,7 +527,9 @@ async function executeAct(node, context, notify) {
 var ActBuilder = class {
 	node;
 	constructor(label) {
-		const id = `act_${label.toLowerCase().replace(/\s+/g, "_")}`;
+		const baseId = `act_${label.toLowerCase().replace(/\s+/g, "_")}`;
+		const existing = getActs();
+		const id = existing.has(baseId) ? nextSuffix(baseId, (id$1) => existing.has(id$1)) : baseId;
 		this.node = createActNode(id, label, [], null, void 0, false);
 		registerActNode(this.node);
 	}
@@ -578,7 +587,9 @@ var ActBuilder = class {
 var FlowBuilder = class {
 	node;
 	constructor(name) {
-		const id = `flow_${name}`;
+		const baseId = `flow_${name}`;
+		const existing = getFlows();
+		const id = existing.has(baseId) ? nextSuffix(baseId, (id$1) => existing.has(id$1)) : baseId;
 		this.node = {
 			id,
 			name,
@@ -623,7 +634,9 @@ var FlowBuilder = class {
 var SurfaceBuilder = class {
 	node;
 	constructor(name) {
-		const id = `surface_${name}`;
+		const baseId = `surface_${name}`;
+		const existing = getSurfaces();
+		const id = existing.has(baseId) ? nextSuffix(baseId, (id$1) => existing.has(id$1)) : baseId;
 		this.node = {
 			id,
 			name,
@@ -662,7 +675,8 @@ function screen(name, fn) {
 		flow: (n) => new FlowBuilder(n),
 		surface: (n) => new SurfaceBuilder(n),
 		resource: (n, config) => {
-			const id = `resource_${n}`;
+			const baseId = `resource_${n}`;
+			const id = configs.some((c) => c.id === baseId) ? nextSuffix(baseId, (id$1) => configs.some((c) => c.id === id$1)) : baseId;
 			const ref = new ResourceRef(id, n, config.load, config.autoLoad ?? true);
 			configs.push({
 				id,
@@ -691,6 +705,28 @@ function screen(name, fn) {
 
 //#endregion
 //#region src/graph.ts
+const NODE_KINDS = {
+	ask: "ask",
+	act: "action",
+	flow: "flow",
+	surface: "surface",
+	resource: "resource"
+};
+function slugify(text) {
+	return text.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+}
+function createSemanticIdFactory(kind) {
+	const prefix = NODE_KINDS[kind] ?? kind;
+	const used = /* @__PURE__ */ new Map();
+	let unnamed = 0;
+	return (source) => {
+		const slug = slugify(source);
+		const base = slug.length > 0 ? slug : String(++unnamed);
+		const count = used.get(base) ?? 0;
+		used.set(base, count + 1);
+		return count === 0 ? `${prefix}:${base}` : `${prefix}:${base}-${count + 1}`;
+	};
+}
 function computeDiagnostics(screenDef) {
 	const diagnostics = [];
 	const primaryActions = screenDef.acts.filter((a) => a.primary);
@@ -728,10 +764,25 @@ function computeDiagnostics(screenDef) {
 	return diagnostics;
 }
 function inspectScreen(screenDef, runtimeResources) {
+	const diagnostics = computeDiagnostics(screenDef);
+	const askIds = createSemanticIdFactory("ask");
+	const actIds = createSemanticIdFactory("act");
+	const flowIds = createSemanticIdFactory("flow");
+	const surfaceIds = createSemanticIdFactory("surface");
+	const resourceIds = createSemanticIdFactory("resource");
+	const idToSemantic = /* @__PURE__ */ new Map();
+	for (const a of screenDef.asks) idToSemantic.set(a.id, askIds(a.label));
+	for (const a of screenDef.acts) idToSemantic.set(a.id, actIds(a.label));
+	const augmentedDiagnostics = diagnostics.map((d) => ({
+		...d,
+		semanticNodeId: d.nodeId ? idToSemantic.get(d.nodeId) : void 0
+	}));
 	return {
 		name: screenDef.name,
+		semanticId: `screen:${slugify(screenDef.name)}`,
 		asks: screenDef.asks.map((a) => ({
 			id: a.id,
+			semanticId: idToSemantic.get(a.id),
 			label: a.label,
 			kind: a.kind,
 			required: a.required,
@@ -741,6 +792,7 @@ function inspectScreen(screenDef, runtimeResources) {
 		})),
 		acts: screenDef.acts.map((a) => ({
 			id: a.id,
+			semanticId: idToSemantic.get(a.id),
 			label: a.label,
 			primary: a.primary,
 			enabled: a.enabled.current,
@@ -751,23 +803,26 @@ function inspectScreen(screenDef, runtimeResources) {
 		})),
 		flows: screenDef.flows.map((f) => ({
 			id: f.id,
+			semanticId: flowIds(f.name),
 			name: f.name,
 			stepCount: f.steps.length
 		})),
 		surfaces: screenDef.surfaces.map((s) => ({
 			id: s.id,
+			semanticId: surfaceIds(s.name),
 			name: s.name,
 			itemCount: s.items.length
 		})),
 		resources: (runtimeResources ?? []).map((r) => ({
 			id: r.id,
+			semanticId: resourceIds(r.name),
 			name: r.name,
 			status: r.status,
 			hasValue: r.value !== void 0,
 			stale: r.stale.current,
 			error: r.status === "failed" ? r.error instanceof Error ? r.error.message : String(r.error) : void 0
 		})),
-		diagnostics: computeDiagnostics(screenDef)
+		diagnostics: augmentedDiagnostics
 	};
 }
 

package/dist/registry.d.ts

@@ -23,3 +23,4 @@ export declare function getActs(): Map<string, ActNode<any>>;
 export declare function getFlows(): Map<string, FlowNode>;
 export declare function getSurfaces(): Map<string, SurfaceNode>;
 export declare function getResources(): Map<string, AnyResourceNode>;
+export declare function nextSuffix(baseId: string, exists: (id: string) => boolean): string;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.1",
   "description": "Platformless semantic graph and runtime for Intent applications",
   "license": "MIT",
   "repository": {