@snaptrude/plugin-core 1.0.1 → 1.1.0-dev.20261025.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snaptrude/plugin-core",
-  "version": "1.0.1",
+  "version": "1.1.0-dev.20261025.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/src/api/design/networks.ts

@@ -1,5 +1,6 @@
 import * as z from "zod"
 import type { PluginApiReturn } from "../../types"
+import { Vec3Handle } from "../../handles"
 
 const id = z.string().regex(/^[A-Za-z][A-Za-z0-9_-]{0,79}$/)
 const vector = z.tuple([
@@ -412,6 +413,47 @@ export const NetworkCreateArgs = NetworkValidateArgs.extend({
   requestId: z.string().uuid(),
 })
 export const NetworkGetArgs = z.object({ graphId: z.string().uuid() }).strict()
+/** Displacement components are world millimetres, Y up, not Snaptrude units. */
+export const NetworkMoveEdgeArgs = NetworkGetArgs.extend({
+  expectedRevision: z.number().int().positive(),
+  edgeId: id,
+  displacement: Vec3Handle,
+  requestId: z.string().uuid(),
+}).strict()
+export type NetworkMoveEdgeArgs = z.input<typeof NetworkMoveEdgeArgs>
+
+export const NetworkMoveEdgeResult = z.object({
+  graphId: z.string().uuid(),
+  revision: z.number().int().positive(),
+  affectedComponentIds: z.array(z.string().min(1)),
+  alreadyApplied: z.boolean(),
+  /** Queue acceptance does not acknowledge durable storage. */
+  saveStatus: z.enum(["queued", "existing"]),
+}).strict()
+export type NetworkMoveEdgeResult = z.infer<typeof NetworkMoveEdgeResult>
+
+/** Immutable receipts survive undo. Retrying a move never executes it again. */
+export const NetworkEditReceipt = z.object({
+  requestId: z.string().uuid(),
+  fingerprint: z.string().max(1000),
+  revision: z.number().int().positive(),
+  affectedComponentIds: z.array(z.string().min(1)).max(1000),
+}).strict()
+export type NetworkEditReceipt = z.infer<typeof NetworkEditReceipt>
+
+/** Each intentional apply/undo/redo has its own identity. Retries reuse it. */
+export const NetworkTransition = z.object({
+  id: z.string().uuid(),
+  expectedRevision: z.number().int().positive(),
+  forward: z.boolean(),
+}).strict()
+export type NetworkTransition = z.infer<typeof NetworkTransition>
+
+export const NetworkTransitionReceipt = NetworkTransition.extend({
+  requestId: z.string().uuid(),
+  revision: z.number().int().positive(),
+}).strict()
+export type NetworkTransitionReceipt = z.infer<typeof NetworkTransitionReceipt>
 export const NetworkContextArgs = z
   .object({
     offset: z.number().int().nonnegative().default(0),
@@ -474,10 +516,12 @@ export type NetworkComponentBinding = z.infer<typeof NetworkComponentBinding>
 export interface SavedNetworkGraph {
   id: string
   domain: NetworkDomain
-  revision: 1
+  revision: number
   requestId: string
   document: NetworkGraphDocument
   components: NetworkComponentBinding[]
+  edits?: NetworkEditReceipt[]
+  transitions?: NetworkTransitionReceipt[]
 }
 export interface NetworkCreateResult {
   graphId: string
@@ -602,6 +646,22 @@ export abstract class PluginDomainNetworkApi {
 /** Electrical equipment, physical routes and logical circuits, constructed from agent-authored intent. */
 export abstract class PluginElectricalApi extends PluginDomainNetworkApi {}
 /** Plumbing equipment and routed pipe networks, constructed from agent-authored intent. */
-export abstract class PluginPlumbingApi extends PluginDomainNetworkApi {}
+export abstract class PluginPlumbingApi extends PluginDomainNetworkApi {
+  /** Offset one straight pipe perpendicular to its axis between two rigid 90-degree elbows.
+   * Resize adjacent pipes through instance length parameters. Out-of-plane offsets add
+   * one pinned elbow and straight pipe per affected end, preserving fixed outer ports
+   * and existing component identities. Rigid fittings only rotate and translate.
+   * Reject axial sliding, moving tees, constrained fittings,
+   * scene drift, stale revisions, and infeasible family geometry before mutation.
+   * @param args Graph/edge identity, current revision, displacement handle in world mm,
+   * and a unique retry identity. Identical retries return the original receipt after undo too.
+   * @returns Affected component IDs and revision in one undoable, queued transaction.
+   * @example
+   * const displacement = await snaptrude.core.math.vec3.new(0, 300, 0)
+   * await snaptrude.design.plumbing.moveEdge({ graphId, edgeId, expectedRevision,
+   *   displacement, requestId: crypto.randomUUID() })
+   */
+  abstract moveEdge(args: NetworkMoveEdgeArgs): PluginApiReturn<NetworkMoveEdgeResult>
+}
 /** Family-backed air-side HVAC networks. The agent authors engineering intent; the host constructs it. */
 export abstract class PluginMechanicalApi extends PluginDomainNetworkApi {}