@relkit/graph 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @relkit/graph
+
+Unsupported internal RELKIT graph model; use @relkit/app.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/diff-types.d.ts

@@ -0,0 +1,31 @@
+import type { JsonValue, SourceLocation } from "@relkit/contracts";
+export declare const GRAPH_DIFF_CLASSIFICATIONS: readonly ["informational", "compatible", "potentially-breaking", "breaking"];
+export type GraphDiffClassification = (typeof GRAPH_DIFF_CLASSIFICATIONS)[number];
+export type GraphDiffCategory = "route" | "function/error" | "event/selector" | "job" | "bucket/cache" | "tool" | "agent" | "profile" | "service";
+export type GraphDiffChange = "added" | "removed" | "changed" | "source-moved";
+export interface SelectorExpansionDiff {
+    readonly added: readonly string[];
+    readonly removed: readonly string[];
+}
+export interface GraphChange {
+    readonly category: GraphDiffCategory;
+    readonly kind: string;
+    readonly id: string;
+    readonly change: GraphDiffChange;
+    readonly classification: GraphDiffClassification;
+    readonly fields: readonly string[];
+    readonly details: readonly string[];
+    readonly source?: {
+        readonly before: SourceLocation;
+        readonly after: SourceLocation;
+    };
+    readonly selectorExpansion?: SelectorExpansionDiff;
+    readonly before?: JsonValue;
+    readonly after?: JsonValue;
+}
+export interface GraphDiff {
+    readonly changes: readonly GraphChange[];
+    readonly hasBreakingChanges: boolean;
+    readonly highestClassification: GraphDiffClassification | undefined;
+}
+//# sourceMappingURL=diff-types.d.ts.map

package/dist/diff-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-types.d.ts","sourceRoot":"","sources":["../src/diff-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE,eAAO,MAAM,0BAA0B,8EAK7B,CAAC;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,gBAAgB,GAChB,gBAAgB,GAChB,KAAK,GACL,cAAc,GACd,MAAM,GACN,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AACd,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,uBAAuB,GAAG,SAAS,CAAC;CACrE"}

package/dist/diff-types.js

@@ -0,0 +1,7 @@
+export const GRAPH_DIFF_CLASSIFICATIONS = [
+    "informational",
+    "compatible",
+    "potentially-breaking",
+    "breaking",
+];
+//# sourceMappingURL=diff-types.js.map

package/dist/diff-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-types.js","sourceRoot":"","sources":["../src/diff-types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,eAAe;IACf,YAAY;IACZ,sBAAsB;IACtB,UAAU;CACF,CAAC"}

package/dist/diff-utils.d.ts

@@ -0,0 +1,11 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { GraphNode } from "./model.js";
+import type { GraphDiffCategory, GraphDiffChange, GraphDiffClassification, SelectorExpansionDiff } from "./diff-types.js";
+export declare function nodeKey(node: GraphNode): string;
+export declare function categoryFor(node: GraphNode): GraphDiffCategory | undefined;
+export declare function contractValue(node: GraphNode): JsonValue;
+export declare function changedFields(before: JsonValue, after: JsonValue): readonly string[];
+export declare function selectorExpansionDiff(before: GraphNode, after: GraphNode): SelectorExpansionDiff;
+export declare function hasExpansionChange(value: SelectorExpansionDiff): boolean;
+export declare function classifyChange(category: GraphDiffCategory, change: GraphDiffChange, fields: readonly string[], before: GraphNode | undefined, after: GraphNode | undefined, expansion: SelectorExpansionDiff | undefined): GraphDiffClassification;
+//# sourceMappingURL=diff-utils.d.ts.map

package/dist/diff-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-utils.d.ts","sourceRoot":"","sources":["../src/diff-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAe1E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAMxD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAIpF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,qBAAqB,CAOhG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAExE;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,SAAS,EAAE,qBAAqB,GAAG,SAAS,GAC3C,uBAAuB,CAazB"}

package/dist/diff-utils.js

@@ -0,0 +1,167 @@
+import { canonicalJson } from "@relkit/contracts";
+export function nodeKey(node) {
+    return `${categoryFor(node)}\0${node.id}`;
+}
+export function categoryFor(node) {
+    if (node.kind === "trigger") {
+        if (node.triggerType === "http")
+            return "route";
+        if (node.triggerType === "event")
+            return "event/selector";
+        return "job";
+    }
+    if (node.kind === "function")
+        return "function/error";
+    if (node.kind === "event")
+        return "event/selector";
+    if (node.kind === "job")
+        return "job";
+    if (node.kind === "bucket" || node.kind === "cache")
+        return "bucket/cache";
+    if (node.kind === "tool")
+        return "tool";
+    if (node.kind === "agent")
+        return "agent";
+    if (node.kind === "provider")
+        return "profile";
+    if (node.kind === "service")
+        return "service";
+    return undefined;
+}
+export function contractValue(node) {
+    if (node.kind !== "trigger" || node.triggerType !== "event" || !isRecord(node.config)) {
+        return withoutSource(node);
+    }
+    const { expansion: _expansion, ...config } = node.config;
+    return withoutSource({ ...node, config });
+}
+export function changedFields(before, after) {
+    if (!isRecord(before) || !isRecord(after))
+        return ["value"];
+    const keys = new Set([...Object.keys(before), ...Object.keys(after)]);
+    return [...keys].filter((key) => !same(before[key], after[key])).sort();
+}
+export function selectorExpansionDiff(before, after) {
+    const left = expansion(before);
+    const right = expansion(after);
+    return {
+        added: right.filter((value) => !left.includes(value)),
+        removed: left.filter((value) => !right.includes(value)),
+    };
+}
+export function hasExpansionChange(value) {
+    return value.added.length > 0 || value.removed.length > 0;
+}
+export function classifyChange(category, change, fields, before, after, expansion) {
+    if (change === "source-moved")
+        return "informational";
+    if (change === "added")
+        return "compatible";
+    if (change === "removed")
+        return "breaking";
+    if (category === "route")
+        return "breaking";
+    if (category === "function/error")
+        return classifyFunction(fields, before, after);
+    if (category === "event/selector")
+        return classifyEvent(fields, expansion);
+    if (category === "job")
+        return classifyJob(fields);
+    if (category === "bucket/cache")
+        return classifyResource(fields, before, after);
+    if (category === "tool")
+        return classifyTool(fields);
+    if (category === "agent")
+        return classifyAgent(fields);
+    if (category === "service")
+        return classifyService(fields);
+    return fields.length === 0 ? "informational" : "potentially-breaking";
+}
+function classifyFunction(fields, before, after) {
+    if (fields.includes("output") || fields.includes("errors"))
+        return "breaking";
+    if (fields.includes("input"))
+        return inputSchemaClass(before, after);
+    return fields.length === 0 ? "informational" : "potentially-breaking";
+}
+function classifyEvent(fields, expansion) {
+    if (expansion?.removed.length)
+        return "breaking";
+    if (expansion?.added.length)
+        return "potentially-breaking";
+    return fields.length === 0 ? "informational" : "breaking";
+}
+function classifyJob(fields) {
+    if (fields.some((field) => ["input", "targetFunctionId", "idempotency"].includes(field)))
+        return "breaking";
+    return fields.length === 0 ? "informational" : "potentially-breaking";
+}
+function classifyResource(fields, before, after) {
+    if (fields.some((field) => ["key", "value", "visibility"].includes(field)))
+        return "breaking";
+    if (fields.includes("profile"))
+        return "potentially-breaking";
+    if (before?.kind === "cache" && after?.kind === "cache" && fields.length > 0)
+        return "breaking";
+    return fields.length === 0 ? "informational" : "potentially-breaking";
+}
+function classifyTool(fields) {
+    if (fields.includes("targetFunctionId"))
+        return "breaking";
+    if (fields.some((field) => ["sideEffect", "approval", "timeoutMs"].includes(field)))
+        return "potentially-breaking";
+    return fields.length === 0 ? "informational" : "compatible";
+}
+function classifyAgent(fields) {
+    if (fields.some((field) => ["input", "output"].includes(field)))
+        return "breaking";
+    return fields.length === 0 ? "informational" : "potentially-breaking";
+}
+function classifyService(fields) {
+    if (fields.includes("members"))
+        return "breaking";
+    if (fields.includes("middleware"))
+        return "potentially-breaking";
+    return fields.length === 0 ? "informational" : "compatible";
+}
+function inputSchemaClass(before, after) {
+    if (before?.kind !== "function" || after?.kind !== "function")
+        return "potentially-breaking";
+    const left = objectSchema(before.input);
+    const right = objectSchema(after.input);
+    if (!left || !right)
+        return "potentially-breaking";
+    const addedRequired = right.required.some((field) => !left.required.includes(field));
+    return addedRequired ? "breaking" : "potentially-breaking";
+}
+function objectSchema(value) {
+    if (!isRecord(value) || value.type !== "object")
+        return undefined;
+    const required = Array.isArray(value.required)
+        ? value.required.filter((entry) => typeof entry === "string")
+        : [];
+    return { required };
+}
+function expansion(node) {
+    if (node.kind !== "trigger" || node.triggerType !== "event" || !isRecord(node.config))
+        return [];
+    return Array.isArray(node.config.expansion)
+        ? node.config.expansion.filter((entry) => typeof entry === "string").sort()
+        : [];
+}
+function withoutSource(node) {
+    const { source: _source, ...value } = node;
+    return value;
+}
+function same(left, right) {
+    try {
+        return canonicalJson(left) === canonicalJson(right);
+    }
+    catch {
+        return Object.is(left, right);
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=diff-utils.js.map

package/dist/diff-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-utils.js","sourceRoot":"","sources":["../src/diff-utils.ts"],"names":[],"mappings":"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"}

package/dist/diff.d.ts

@@ -0,0 +1,8 @@
+import { type GraphCanonicalizationOptions } from "./hash.js";
+import type { ApplicationGraph } from "./model.js";
+import type { GraphDiff } from "./diff-types.js";
+/** Compares canonical graph contracts while ignoring source-only identity moves. */
+export declare function diffGraph(before: ApplicationGraph, after: ApplicationGraph, options?: GraphCanonicalizationOptions): GraphDiff;
+/** Alias matching command-style callers that compare two graph documents. */
+export declare const diffGraphs: typeof diffGraph;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,YAAY,CAAC;AAU9D,OAAO,KAAK,EAEV,SAAS,EAGV,MAAM,iBAAiB,CAAC;AAEzB,oFAAoF;AACpF,wBAAgB,SAAS,CACvB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,4BAAiC,GACzC,SAAS,CAaX;AAED,6EAA6E;AAC7E,eAAO,MAAM,UAAU,kBAAY,CAAC"}

package/dist/diff.js

@@ -0,0 +1,103 @@
+import { canonicalJson } from "@relkit/contracts";
+import { canonicalizeGraph } from "./hash.js";
+import { categoryFor, changedFields, classifyChange, contractValue, hasExpansionChange, nodeKey, selectorExpansionDiff, } from "./diff-utils.js";
+/** Compares canonical graph contracts while ignoring source-only identity moves. */
+export function diffGraph(before, after, options = {}) {
+    const left = canonicalizeGraph(before, options);
+    const right = canonicalizeGraph(after, options);
+    const beforeNodes = nodesByKey(left.nodes);
+    const afterNodes = nodesByKey(right.nodes);
+    const keys = [...new Set([...beforeNodes.keys(), ...afterNodes.keys()])].sort();
+    const changes = keys.flatMap((key) => makeChanges(beforeNodes.get(key), afterNodes.get(key)));
+    const ordered = changes.sort(compareChanges);
+    return Object.freeze({
+        changes: Object.freeze(ordered),
+        hasBreakingChanges: ordered.some((change) => change.classification === "breaking"),
+        highestClassification: highest(ordered),
+    });
+}
+/** Alias matching command-style callers that compare two graph documents. */
+export const diffGraphs = diffGraph;
+function nodesByKey(nodes) {
+    return new Map(nodes.flatMap((node) => (categoryFor(node) === undefined ? [] : [[nodeKey(node), node]])));
+}
+function makeChanges(left, right) {
+    const node = right ?? left;
+    const category = node === undefined ? undefined : categoryFor(node);
+    if (node === undefined || category === undefined)
+        return [];
+    if (left === undefined)
+        return [entry(category, right, "added", [], undefined, right)];
+    if (right === undefined)
+        return [entry(category, left, "removed", [], left, undefined)];
+    const expansion = selectorExpansionDiff(left, right);
+    const expansionChanged = category === "event/selector" && hasExpansionChange(expansion);
+    const fields = changedFields(contractValue(left), contractValue(right));
+    const allFields = expansionChanged ? [...new Set([...fields, "selector.expansion"])] : fields;
+    if (allFields.length === 0) {
+        if (canonicalJson(left.source) === canonicalJson(right.source))
+            return [];
+        return [entry(category, right, "source-moved", ["source"], left, right)];
+    }
+    return [
+        entry(category, right, "changed", allFields, left, right, expansionChanged ? expansion : undefined),
+    ];
+}
+function entry(category, node, change, fields, before, after, selectorExpansion) {
+    const source = before && after && !sameSource(before, after)
+        ? { before: before.source, after: after.source }
+        : undefined;
+    const result = {
+        category,
+        kind: node.kind,
+        id: node.id,
+        change,
+        classification: classifyChange(category, change, fields, before, after, selectorExpansion),
+        fields: [...fields].sort(),
+        details: details(change, fields, selectorExpansion),
+        ...(source === undefined ? {} : { source }),
+        ...(selectorExpansion === undefined ? {} : { selectorExpansion }),
+        ...(before === undefined ? {} : { before: before }),
+        ...(after === undefined ? {} : { after: after }),
+    };
+    return result;
+}
+function details(change, fields, expansion) {
+    const values = [...fields];
+    if (change === "added")
+        values.push("added");
+    if (change === "removed")
+        values.push("removed");
+    if (change === "source-moved")
+        values.push("source moved");
+    if (expansion !== undefined) {
+        values.push(...expansion.added.map((value) => `selector added ${value}`));
+        values.push(...expansion.removed.map((value) => `selector removed ${value}`));
+    }
+    return [...new Set(values)].sort();
+}
+function sameSource(left, right) {
+    return canonicalJson(left.source) === canonicalJson(right.source);
+}
+function compareChanges(left, right) {
+    return (left.category.localeCompare(right.category) ||
+        left.id.localeCompare(right.id) ||
+        left.change.localeCompare(right.change));
+}
+function highest(changes) {
+    const order = [
+        "informational",
+        "compatible",
+        "potentially-breaking",
+        "breaking",
+    ];
+    return changes.reduce((current, change) => {
+        if (current === "breaking")
+            return current;
+        if (current === undefined || order.indexOf(change.classification) > order.indexOf(current)) {
+            return change.classification;
+        }
+        return current;
+    }, undefined);
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"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"}

package/dist/foundation-nodes.d.ts

@@ -0,0 +1,30 @@
+import type { JsonValue } from "@relkit/contracts";
+import type { GraphNodeBase } from "./model.js";
+export interface AppNode extends GraphNodeBase<"app"> {
+    readonly environment?: JsonValue;
+    readonly providerBindings?: readonly string[];
+    readonly observability?: JsonValue;
+    readonly defaults?: JsonValue;
+}
+export interface EnvironmentVariableNode extends GraphNodeBase<"env"> {
+    readonly name: string;
+    readonly type: string;
+    readonly requiredIn: readonly string[];
+    readonly hasDefault: boolean;
+    readonly sensitive: boolean;
+    readonly description?: string;
+}
+export interface GeneratedAgentMarker {
+    readonly generated: true;
+    readonly generatedBy: "agent";
+    readonly agentId: string;
+    readonly functionId: string;
+}
+export interface GeneratedEventListenerMarker {
+    readonly generated: true;
+    readonly generatedBy: "event-listener";
+    readonly listenerId: string;
+    readonly functionId: string;
+}
+export type GeneratedFunctionMarker = GeneratedAgentMarker | GeneratedEventListenerMarker;
+//# sourceMappingURL=foundation-nodes.d.ts.map

package/dist/foundation-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-nodes.d.ts","sourceRoot":"","sources":["../src/foundation-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,OAAQ,SAAQ,aAAa,CAAC,KAAK,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAwB,SAAQ,aAAa,CAAC,KAAK,CAAC;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG,4BAA4B,CAAC"}

package/dist/foundation-nodes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=foundation-nodes.js.map

package/dist/foundation-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-nodes.js","sourceRoot":"","sources":["../src/foundation-nodes.ts"],"names":[],"mappings":""}

package/dist/graph-edges.d.ts

@@ -0,0 +1,21 @@
+import type { ServiceMemberEdge, ServiceMiddlewareEdge } from "./service-nodes.js";
+export declare const GRAPH_EDGE_KINDS: readonly ["targets-function", "calls-function", "enqueues-job", "publishes-event", "listens-to-event", "uses-bucket", "uses-cache", "invokes-agent", "exposes-as-tool", "uses-tool", "uses-provider-profile", "contains-function", "uses-service-middleware", "uses-middleware", "uses-hook"];
+export type GraphEdgeKind = (typeof GRAPH_EDGE_KINDS)[number];
+export interface GraphEdgeBase<Kind extends GraphEdgeKind = GraphEdgeKind> {
+    readonly kind: Kind;
+    readonly from: string;
+    readonly to: string;
+}
+export interface TargetsFunctionEdge extends GraphEdgeBase<"targets-function"> {
+    readonly role: "primary";
+}
+export interface UsesMiddlewareEdge extends GraphEdgeBase<"uses-middleware"> {
+    readonly order: number;
+    readonly match: "always" | "conditional";
+}
+export interface UsesHookEdge extends GraphEdgeBase<"uses-hook"> {
+    readonly phase: "before" | "after";
+}
+export type GraphEdge = TargetsFunctionEdge | GraphEdgeBase<"calls-function"> | GraphEdgeBase<"enqueues-job"> | GraphEdgeBase<"publishes-event"> | GraphEdgeBase<"listens-to-event"> | GraphEdgeBase<"uses-bucket"> | GraphEdgeBase<"uses-cache"> | GraphEdgeBase<"invokes-agent"> | GraphEdgeBase<"exposes-as-tool"> | GraphEdgeBase<"uses-tool"> | GraphEdgeBase<"uses-provider-profile"> | ServiceMemberEdge | ServiceMiddlewareEdge | UsesMiddlewareEdge | UsesHookEdge;
+export declare function isGraphEdgeKind(value: unknown): value is GraphEdgeKind;
+//# sourceMappingURL=graph-edges.d.ts.map

package/dist/graph-edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-edges.d.ts","sourceRoot":"","sources":["../src/graph-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,eAAO,MAAM,gBAAgB,+RAgBnB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,aAAa,GAAG,aAAa;IACvE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,mBAAoB,SAAQ,aAAa,CAAC,kBAAkB,CAAC;IAC5E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AACD,MAAM,WAAW,kBAAmB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;CAC1C;AACD,MAAM,WAAW,YAAa,SAAQ,aAAa,CAAC,WAAW,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC;AACD,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,aAAa,CAAC,gBAAgB,CAAC,GAC/B,aAAa,CAAC,cAAc,CAAC,GAC7B,aAAa,CAAC,iBAAiB,CAAC,GAChC,aAAa,CAAC,kBAAkB,CAAC,GACjC,aAAa,CAAC,aAAa,CAAC,GAC5B,aAAa,CAAC,YAAY,CAAC,GAC3B,aAAa,CAAC,eAAe,CAAC,GAC9B,aAAa,CAAC,iBAAiB,CAAC,GAChC,aAAa,CAAC,WAAW,CAAC,GAC1B,aAAa,CAAC,uBAAuB,CAAC,GACtC,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,YAAY,CAAC;AAEjB,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/graph-edges.js

@@ -0,0 +1,21 @@
+export const GRAPH_EDGE_KINDS = [
+    "targets-function",
+    "calls-function",
+    "enqueues-job",
+    "publishes-event",
+    "listens-to-event",
+    "uses-bucket",
+    "uses-cache",
+    "invokes-agent",
+    "exposes-as-tool",
+    "uses-tool",
+    "uses-provider-profile",
+    "contains-function",
+    "uses-service-middleware",
+    "uses-middleware",
+    "uses-hook",
+];
+export function isGraphEdgeKind(value) {
+    return typeof value === "string" && GRAPH_EDGE_KINDS.includes(value);
+}
+//# sourceMappingURL=graph-edges.js.map

package/dist/graph-edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-edges.js","sourceRoot":"","sources":["../src/graph-edges.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,kBAAkB;IAClB,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,kBAAkB;IAClB,aAAa;IACb,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,WAAW;IACX,uBAAuB;IACvB,mBAAmB;IACnB,yBAAyB;IACzB,iBAAiB;IACjB,WAAW;CACH,CAAC;AAkCX,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC"}

package/dist/graph-types.d.ts

@@ -0,0 +1,15 @@
+import { GRAPH_VERSION } from "@relkit/contracts";
+import type { GraphEdge, GraphEdgeKind, GraphNode } from "./model.js";
+export interface ObservedEdge {
+    readonly relationship: GraphEdgeKind;
+    readonly from: string;
+    readonly to: string;
+}
+export interface ApplicationGraph {
+    readonly contractVersion: typeof GRAPH_VERSION;
+    readonly appId?: string;
+    readonly nodes: readonly GraphNode[];
+    readonly edges: readonly GraphEdge[];
+}
+export type Graph = ApplicationGraph;
+//# sourceMappingURL=graph-types.d.ts.map

package/dist/graph-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.d.ts","sourceRoot":"","sources":["../src/graph-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,aAAa,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAED,MAAM,MAAM,KAAK,GAAG,gBAAgB,CAAC"}

package/dist/graph-types.js

@@ -0,0 +1,2 @@
+import { GRAPH_VERSION } from "@relkit/contracts";
+//# sourceMappingURL=graph-types.js.map

package/dist/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../src/graph-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/graph-validation.d.ts

@@ -0,0 +1,2 @@
+export declare function validateGraphShape(value: unknown, root?: string): void;
+//# sourceMappingURL=graph-validation.d.ts.map

package/dist/graph-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-validation.d.ts","sourceRoot":"","sources":["../src/graph-validation.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAQtE"}