@nativemason/contracts 0.2.0 → 0.3.0

package/dist/tools.js

@@ -3,14 +3,15 @@ import { AccessibilityFindingSchema } from './accessibility.js';
 import { SuggestionProfilesSchema, SuggestionProfileEvidenceSchema, NativeSuggestionEvidenceSchema, InteractionRequirementSchema } from './diagnostics.js';
 import { LayoutMutationSchema, EditScopeSchema, TransactionPlanSchema, ScenarioScriptSchema, MatrixCellSchema, RuleFindingSchema, InferenceOptionsSchema, NativeTargetSchema } from './workflow.js';
 import { z } from 'zod';
+import { NativeBindHostSchema } from './native-protocol.js';
 import { DeviceProfileSchema, RectSchema } from './geometry.js';
 import { WireframeSpecSchema, ConstraintResultSchema } from './constraints.js';
 import { RnStylePatchSchema } from './styles.js';
-import { SpatialSnapshotSchema, SpatialDeltaSchema, ProfileOverridesSchema, WebDiagnosticsSchema } from './graph.js';
+import { SpatialSnapshotSchema, SpatialDeltaSchema, SpatialNodeSchema, ProfileOverridesSchema, WebDiagnosticsSchema } from './graph.js';
 import { CommitReceiptSchema, EditPlanSchema, BridgeErrorSchema } from './source.js';
 const session = { sessionId: z.string().min(1) };
 export const ToolSchemas = {
-    open_session: z.object({ projectRoot: z.string().min(1), webUrl: z.string().url(), scenarioId: z.string().min(1), profile: DeviceProfileSchema, nativeTarget: NativeTargetSchema.optional(), nativeScenario: z.object({ appId: z.string().min(1), adbSerial: z.string().optional(), maestroPath: z.string().optional(), ssh: z.object({ destination: z.string(), identityFile: z.string().optional() }).strict().optional() }).strict().optional(), nativePort: z.number().int().min(1024).max(65535).optional(), nativeToken: z.string().min(16).optional() }).strict(),
+    open_session: z.object({ projectRoot: z.string().min(1), webUrl: z.string().url(), scenarioId: z.string().min(1), profile: DeviceProfileSchema, nativeTarget: NativeTargetSchema.optional(), nativeScenario: z.object({ appId: z.string().min(1), adbSerial: z.string().optional(), maestroPath: z.string().optional(), ssh: z.object({ destination: z.string(), identityFile: z.string().optional() }).strict().optional() }).strict().optional(), nativeHost: NativeBindHostSchema.optional(), nativePort: z.number().int().min(1024).max(65535).optional(), nativeToken: z.string().min(16).optional() }).strict(),
     import_design_intent: z.object({ ...session, design: DesignIntentSchema }).strict(),
     inspect_accessibility: z.object({ ...session, target: z.enum(['web', 'native']).default('web') }).strict(),
     load_wireframe_spec: z.object({ ...session, spec: WireframeSpecSchema }).strict(),
@@ -29,6 +30,7 @@ export const ToolSchemas = {
 };
 export const TrialSchema = z.object({ trialId: z.string(), baselineSnapshotId: z.string(), elementId: z.string(), patch: RnStylePatchSchema, mutations: z.array(LayoutMutationSchema).optional(), snapshot: SpatialSnapshotSchema, delta: SpatialDeltaSchema, results: z.array(ConstraintResultSchema) }).strict();
 export const NativeVerificationSchema = z.object({ receipt: CommitReceiptSchema, snapshot: SpatialSnapshotSchema, results: z.array(ConstraintResultSchema), delta: SpatialDeltaSchema, passed: z.boolean() }).strict();
+const CommitRnAstPatchOutputBaseSchema = z.object({ plan: EditPlanSchema.optional(), transactionPlan: TransactionPlanSchema.optional(), receipt: CommitReceiptSchema.optional(), snapshot: SpatialSnapshotSchema.nullable().optional(), results: z.array(ConstraintResultSchema).optional(), webStatus: z.enum(['passed', 'failed', 'reload-timeout', 'capture-failed', 'native-checks-pending', 'interaction-pending']).optional(), nativeStatus: z.literal('pending').optional(), pendingNativeConstraints: z.array(z.string()).optional(), pendingInteractions: z.array(InteractionRequirementSchema).optional(), message: z.string().optional() }).strict();
 /** Every JSON tool result is validated here before reaching an MCP client. */
 export const ToolOutputSchemas = {
     open_session: z.object({ sessionId: z.string(), native: z.object({ port: z.number().int(), token: z.string() }).strict(), capabilities: z.object({ trial: z.literal('rn-style-props'), sourceEdits: z.enum(['static-local-styles', 'scoped-transactions']), batchTrials: z.boolean().optional(), nativePlatforms: z.array(z.enum(['android', 'ios'])).optional(), nativeScenario: z.boolean().optional(), nativeVerification: z.literal('required') }).strict() }).strict(),
@@ -38,10 +40,10 @@ export const ToolOutputSchemas = {
     inspect_ui_spatial_graph: z.object({ snapshot: SpatialSnapshotSchema, results: z.array(ConstraintResultSchema), webDiagnostics: WebDiagnosticsSchema.optional() }).strict(),
     capture_annotated_overlay: z.object({ image: z.string(), mimeType: z.literal('image/png'), artifact: z.string(), marks: z.array(z.object({ label: z.number(), id: z.string(), rect: RectSchema }).strict()) }).strict(),
     simulate_layout_mutation: z.union([TrialSchema.extend({ webDiagnostics: WebDiagnosticsSchema.optional() }), z.object({ snapshot: SpatialSnapshotSchema, results: z.array(ConstraintResultSchema), webDiagnostics: WebDiagnosticsSchema.optional() }).strict()]),
-    commit_rn_ast_patch: z.object({ plan: EditPlanSchema.optional(), transactionPlan: TransactionPlanSchema.optional(), receipt: CommitReceiptSchema.optional(), snapshot: SpatialSnapshotSchema.nullable().optional(), results: z.array(ConstraintResultSchema).optional(), webStatus: z.enum(['passed', 'failed', 'reload-timeout', 'capture-failed', 'native-checks-pending', 'interaction-pending']).optional(), nativeStatus: z.literal('pending').optional(), pendingNativeConstraints: z.array(z.string()).optional(), pendingInteractions: z.array(InteractionRequirementSchema).optional(), message: z.string().optional() }).strict().refine(o => (o.plan !== undefined) !== (o.receipt !== undefined), 'Result must contain either a preview plan or an applied receipt'),
+    commit_rn_ast_patch: CommitRnAstPatchOutputBaseSchema.refine(o => (o.plan !== undefined) !== (o.receipt !== undefined), 'Result must contain either a preview plan or an applied receipt'),
     verify_native_layout: NativeVerificationSchema,
     revert_commit: z.object({ receipt: CommitReceiptSchema, snapshot: SpatialSnapshotSchema.nullable(), nativeStatus: z.literal('pending') }).strict(),
-    find_elements: z.object({ nodes: z.array(SpatialSnapshotSchema.innerType().shape.nodes.element) }).strict(),
+    find_elements: z.object({ nodes: z.array(SpatialNodeSchema) }).strict(),
     infer_constraints: z.object({ spec: WireframeSpecSchema, findings: z.array(RuleFindingSchema) }).strict(),
     suggest_fix: z.object({ candidates: z.array(z.object({ mutations: z.array(LayoutMutationSchema), reason: z.string(), constraintIds: z.array(z.string()), results: z.array(ConstraintResultSchema), score: z.number(), warnings: z.number(), profiles: z.array(SuggestionProfileEvidenceSchema).optional(), error: BridgeErrorSchema.optional() })), baselineSnapshotId: z.string(), baselines: z.array(SuggestionProfileEvidenceSchema).optional(), nativeBaseline: NativeSuggestionEvidenceSchema.optional() }).strict(),
     run_scenario: z.object({ snapshot: SpatialSnapshotSchema, results: z.array(ConstraintResultSchema) }).strict(),
@@ -50,4 +52,4 @@ export const ToolOutputSchemas = {
 };
 /** MCP's object-root output schema describes both existing trial and reset wire shapes.
  * ToolOutputSchemas still enforces the complete union before any response is sent. */
-export const ToolMcpOutputSchemas = { ...ToolOutputSchemas, commit_rn_ast_patch: ToolOutputSchemas.commit_rn_ast_patch.innerType(), simulate_layout_mutation: TrialSchema.partial().extend({ snapshot: SpatialSnapshotSchema, results: z.array(ConstraintResultSchema), webDiagnostics: WebDiagnosticsSchema.optional() }).strict() };
+export const ToolMcpOutputSchemas = { ...ToolOutputSchemas, commit_rn_ast_patch: CommitRnAstPatchOutputBaseSchema, simulate_layout_mutation: TrialSchema.partial().extend({ snapshot: SpatialSnapshotSchema, results: z.array(ConstraintResultSchema), webDiagnostics: WebDiagnosticsSchema.optional() }).strict() };